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Premessa 


Chi deve usare questo manuale 


Questo manuale fornisce ai programmatori le informazioni necessarie per creare 
procedure per il Sistema/36 IBM. Esso fornisce agli operatori e aì programmatori 
le informazioni di riferimento necessarie per identificare e usare le procedure, i 
comandi di controllo, le specifiche del linguaggio di controllo operativo (OCL) e i 
programmi di utilità del programma per il supporto del sistema (SSP). 


Questa sezione descrive cosa contiene il manuale nonché il metodo usato per 
mostrare i formati delle specifiche. © 


Come è organizzato questo manuale 


Questo manuale contiene i seguenti capitoli e appendici: 


ll Capitolo 1 presenta il supporto di sistema e il metodo usato per descrivere i 
formati di sintassi indicati nel manuale. Questo capitolo contiene anche un elenco 
delle funzioni che è possibile eseguire usando il supporto di sistema. Questo 
elenco è indicato da una barra sul margine della pagina; usare questa barra come 
aiuto per ritrovare questo elenco. 


li Capitolo 2 descrive come è possibile scrivere le proprie procedure. 


Il Capitolo 3 descrive ciascuna espressione e specifica che è possibile usare nelle 
procedure. Si tratta delle cosiddette espressioni di controllo procedura. 


11 Capitolo 4 descrive ciascuna procedura fornita dalla IBM. 


ll Capitolo 5 descrive ciascuna specifica di linguaggio di controllo operativo 
(OGL). 


Il Capitolo 6 descrive ciascun comando di controllo. 


L'Appendice A mostra le specifiche OCL e le specifiche di controllo dei pro- 
grammi di utilità che è possibile usare invece delle procedure SSP fornite dalla 
IBM. Sono indicate soltanto per le procedure SSP; quelle per altre procedure 
fornite dalla IBM non sono indicate. E' possibile usare questo capitolo per scrive- 
re le proprie procedure sulla base di quelle SSP fornite dalla IBM. Inoltre, se un 
programma di utilità SSP prevede delle funzioni che non sono supportate dalle 
procedure SSP fornite dalla IBM, in questa appendice sono descritte tali funzioni 
addizionali, 


L'Appendice B descrive la relazione tra record, blocchi e settori del disco. 
L'Appendice C descrive le procedure di sussidio di servizio. 


L'Appendice D descrive i programmi di conversione delle serie di caratteri 
multinazionali. 


L'Appendice E elenca i caratteri sulle cinghie di stampa standard 48, 48HN, 64B, 
64C, 96 e 188 caratteri. Questa appendice elenca inoltre le tabelle per la conver- 
sione dei caratteri delle cinghie di stampa. 


L'Appendice F elenca le tabelle dei codici EBCDIC e ASCII. Questa appendice mo- 
stra inoltre le tabelle per la conversione esadecimale e decimale. 


Appendice G descrive la procedura IDDUXLAT. 


Cosa si dovrebbe conoscere 


e /BM System/36 Learning about Your Computer, SC21-9018, che contiene 
materiale introduttivo sul Sistema/36 IBM. Occorre leggere questo manuale 
per primo se non si ha familiarità con il Sistema/36. 


e /BM System6 Concepts and Programmers Guide, SC21-9019, descrive 
come funziona il sistema e contiene inoltre le informazioni sulle tecniche da 
usare nella programmazione del Sistema/36. 


Se occorrono altre informazioni 


Manuali generici relativi a SSP 
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Si potrebbe aver bisogno di alcuni o di tutti i seguenti manuali IBM prima o 
durante l'uso di questo manuale. Salvo dove altrimenti indicato, si tratta di ma- 
nuali del Sistema/36. 


e Guide Publications, GC21-9015, contiene una guida generale alle pubblica- 
zioni del Sistema/36, un glossario di tutti i termini usati nelle pubblicazioni 
del Sistema/36 e una lista di argomenti e di manuali in cui è possibile indi- 
viduare ciascun argomento. 


e Guida Operativa, SC13-5081, descrive come far funzionare il Sistema/36. 


e Guida ai Messaggi del Sisterna, SC13-5072, descrive i messaggi che il Siste- 
ma/36 visualizza o stampa. ì 


e Guida alla Definizione dei Tracciati Video, SC13-5070, descrive come creare 
e modificare i tracciati video e i menù usando il sussidio per il disegno degli 
schermi (SDA) o il programma di supporto sistema (SSP). 


e Modifica della Configurazione del Sistema, SC13-5093, descrive come confi- 


gurare il sistema e come installare i programmi di sistema. 


e Guida alla Riservatezza del Sistema, $C13-5082, descrive come proteggere il 
sistema dagli utenti non autorizzati e il modo in cui proteggere i dati, 


e System Measurement Facility Guide, SC21-9025, descrive le procedure del 


programma di supporto per rilevare le prestazioni del sistema (SMF) e come 
interpretare le informazioni stampate da queste procedure. 


Diagnostica di Sistema, SC13-5072, descrive ciò che è possibile fare prima di 
chiedere l'intervento della IBM per l'assistenza al sistema, 


Diskette General Information Manual, GA21-9182, descrive i minidischi e il 
modo in cui manipolarli, Questo non è un manuale del Sistema/36. 


Manuali dei programmi di utilità e dei linguaggi di programmazione 


Manuali per comunicazioni 


Programma di Utilità per Immissione di dati origine (SEU = Source Entry 
Utility), SC13-5069, descrive come eseguire il SEU per creare e modificare 
procedure e membri origine, 


Programmazione RPG I, SC13-5074 
Programming with BASIC, SC21-9003 
Programming with COBOL, SC21-9007 
Programming with FORTRAN IV, SC21-9005 
Programming with Assembler, SC21-7908 


Overlay Linkage Editor Guide, SC21-9041, descrive come eseguire l'edizione 
di moduli oggetto dei programmi compilati. 


Programma di Selezione - SORT, SC13-5071, descrive come selezionare i file 
di dati usando il programma di selezione. 


Programma di Utilità per File di Dati (DFU = Data File Utility}, SC13-5068, 
descrive come creare, modificare, visualizzare e listare file di dati usando il 
DFU. 


Work Station Utility Guide, SC21-7905, descrive come creare programmi 
usando il WSU. 


Business Graphics Utilies/36 User's Guide, SC21-7985, descrive come dise- 
gnare grafici e diagrammi utilizzando il BGU/36. 


Programma di utilità di supporto alla programmazione, SC13-5139 descrive co- 
me creare, editare, stampare, rimuovere e visualizzare membri di procedura e 
membri origine di libreria con il DSU (Development Support Utility). 


Interactive Communications Feature: Reference, SC21-7910, descrive i sotto- 
sistemi Interactive Communications Feature (SSP-ICF). 


Interactive Communications Feature: Guide and Examples, SC21-7911, de- 
scrive i sottosistemi dell’Interactive Communication Feature (SSP-1CF). 


3270 Device Emulation Guide, SC21-7912, descrive come usare l'emulazione 
di unità 3270. 


Multiple Session Remote Job Entry Guide, SC21-7909, descrive come usare 
immissione lavori a distanza. 


Programmazione RPGII, SC13-5074, descrive come usare il BSC non interat- 
tivo con l'RPG. 
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e Programming with Assembler, SC21-7908, descrive come usare il BSC non 
interattivo con l’Assembler. 


e Communications and system management guide, SC21-8010, descrive il sup- 
porto modifica gestione (DSNX) ed il supporto diagnostica di gestione che per- 
mette al Sistema/36 di creare e mandare segnali. 


e Distributed data management guide, SC21-8011, descrive come utilizzare l’in- 
dirizzario risorse di rete e il DDM. 


* PC support/36 technical reference, SC21-9097, descrive il programma di sup- 
porto per il Personal Computer IBM. 


e Using system/36 communications, SC21-9082, descrive il supporto fornito dal 
dispositivo base di comunicazione. 


e  Usingthe Asynchronous Communications Support, SC21-9143, descrive il sup- 
porto di comunicazioni asincrone. 


Se occorre materiale di programmazione o di ricerca e correzione degli errori 


e /BM 5250 Keyboard Template Assignment Sheet and Display Screen Layout 
Sheet, GX21-9271, un foglio schematico per aiutare a creare tracciati video. 


e /BM Display Format Specifications, GX21-9800. Si tratta di fogli di codifica 
per aiutare a creare tracciati video. 


e. /BM RPG Debugging, GX21-9129. Si tratta di una mascherina per aiutare a 
risolvere i problemi RPG. 


e /BM WSU/$SFGR Debugging Template, GX21-7926. Si tratta di una masche- 
rina per aiutare a correggere i problemi WSU e di tracciato video. 


e /BM Keyboard Template, GX21-7929. Mostra i tasti di comando usati con i 
programmi su licenza del Sistema/36. 


e /BM Command Key Template, GX21-9799. Si tratta di una mascherina ade- 
siva da usare con le unità video 5251. 


e Quelle che seguono sono mascherine di plastiche in bianco sulle quali è pos- 
sibile applicare informazioni relative ai tasti di comando usati dai programmi: 


— IBM 5251 Models 1 and 11 and IBM 5252 Dual Display Station Key- 
board Template, GX21-9266 

— IBM 5251 Display Station Models 2 and 12 Keyboard Template, 
GX21-9327 

— IBM 5291 Display Station Keyboard Template, GX21-9410 

— IBM 5292 Display Station Keyboard Template, GX21-9414 


e /BM 5292 Color Display Station Select Options, GX21-9451. Mostra come 
controllare i dispositivi speciali sull'unità video 5292. 


Se non si conoscono i termini usati in questo manuale 


Molti termini e concetti sono chiariti nel manuale Learning about Your Computer. 
Se non si ha familiarità con il S/36 è consigliabile leggere questo manuale. 


Indici aggiuntivi 


Degli indici aggiuntivi sono disponibili per suddividere in sezioni questo manuale. 
Ciò comporta una più rapida ricerca delle informazioni. La. richiesta di questi 
indici va fatta al rappresentante IBM o all'ufficio IBM responsabile della zona. Il 
titolo e il numero d'ordine è: /nsert Tabs for the IBM System/36 System Refe- 
rence, SC21-9801. 
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Capitolo 1. Introduzione 


Questo manuale descrive le procedure, i comandi di controlio, le specifiche del 
linguaggio di controllo operativo (OCL) e le espressioni di controllo procedura 
fornite con il programma di supporto del sistema (SSP) e altri programmi su 
licenza, 


PROCEDURE 


Si usano le procedure per eseguire una funzione sul sistema, ad esempio per lista- 
re i contenuti di un file su disco o per eseguire un programma. 


Una procedura è una raccolta di specifiche che fanno sì che uno o più program- 
mi vengano eseguiti. Un comando è un'istruzione che dice al sistema di fare qual- 
che cosa. Le procedure consentono di evitare di immettere, quando necessario, 
le specifiche di uso frequente. 


Per eseguire le procedure, si batte un comando di procedura sulla tastiera. Un 
comando di procedura contiene il nome della procedura da eseguire e informa 
zioni opzionali che definiscono la funzione da svolgere dalla procedura. Per esem- 
pio, è possibile immettere quanto segue per eseguire una procedura fornita dalla 
IBM denominata SYSLIST: 


SYSLIST 


Questo comando di procedura contiene soltanto il nome della procedura da 
eseguire. 


I comandi di procedura sono solitamente immessi con le informazioni che dicono 
alla procedura che cosa fare, L'esempio che segue mostra come è possibile immet- 
tere un comando per eseguire una procedura fornita dalla IBM denominata LIST- 
LIBR per listare un membro di libreria denominato PAYROLL: 


LISTLIBR PAYROLL 


Un altro modo per eseguire una procedura consiste nel creare un menù. | menù 
consentono d’immettere un numero che corrisponde al comando di esecuzione 
procedura anzichè dover immettere l’intero comando. Vedere il manuale Guida 
alla Definizione dei Tracciati Video per ulteriori informazioni sulla creazione di 
menù, 


Molte procedure sono fornite come parte del SSP e di altri programmi su licenza. 
Le procedure SSP consentono di creare file di dati e librerie; salvare, ripristinare 
e copiare file di dati e librerie; e listare informazioni su file di dati, librerie e sul 
sisterna. Le procedure dei programmi su licenza consentono di creare e modifica- 
re membri di libreria e di compilare programmi. Vedere Capitolo 4, Procedure, 
per informazioni dettagliate sulle procedure SSP e sulle procedure dei programmi 
su licenza. 


E' possibije creare procedure per il Sistema/36. Per queste informazioni vedere 
il Capitolo 2, Creazione di proprie procedure. 


SPECIFICHE OCL 


Le specifiche di /inguaggio controllo operativo (OCL) forniscono al SSP tutte le 
informazioni che deve conoscere circa i lavori da eseguire. Le specifiche OCL 
sono normalmente contenute in procedure, quantunque esse possano essere im- 
messe da tastiera. Vedere il Capitolo 5, Specifiche OCL, per informazioni detta- 


gliate sulle specifiche OCL. 


PROGRAMMI DI UTILITA" SSP E RISPETTIVE SPECIFICHE DI 
CONTROLLO 


I programmi di utilità SSP sono forniti dalla IBM come parte di SSP per eseguire 
talune funzioni, ad esempio una copia di un file su disco, la lista di un membro di 
libreria o la comunicazione con un altro sistema. 


Quando viene eseguito un programma di utilità SSP, le specifiche OCL identificano 
il programma e forniscono le informazioni addizionali richieste, Oltre alle specifiche 
OCL, ie specifiche di controllo del programma di utilità, definiscono le funzioni da 
eseguire dal programma di utilità SSP. Normalmente una procedura contiene le 
specifiche OCL e le specifiche di controllo del programma di utilità richieste per 
eseguire un lavoro. 


Il seguente esempio mostra le specifiche richieste per listare un membro di libreria 
denominato PAYROLL. Viene eseguito il protramma di utilità $MAINT. Le specifi- 
che LOAD e RUN sono specifiche OCL; le specifiche di controllo del programma di 
utilità, sono COPY e END. 


// LOAD $MAINT 

// RUN 

// COPY FROM-PAYLIB,TO-PRINT,NAME-PAYROLL,LIBRARY-S 
// END 


Le specifiche in questo esempio indicano quanto segue: 


LOAD Questa specifica OCL carica il $MAINT nella memoria 
centrale. Il $MAINT è uno dei programmi di utilità del 
SSP. 

RUN Questa specifica OCL inizia l'esecuzione del programma 
$MAINT. 

COPY Questa specifica di controllo del programma di utilità 
passa informazioni al programma $MAINT. Le informa- 
zioni sono: 


FROM-PAYLIB La libreria che contiene il membro 
è denominata PAYLIB. 


TO-PRINT Le informazioni sono da stampare. 


NAME-PAYROLL Si usa un membro di libreria deno- 
minato PAYROLL. 


LIBRARY-S Il membro di libreria è un membro 
origine. 


Usando tutti e quattro gli elementi d'informazione, al 
programma $MAINT viene detto di stampare un mem- 
bro origine di libreria denominato PAYROLL dalla libre- 
ria denominata PAYLIB. 


END Questa specifica di controllo del programma di utilità, 
indica che non seguono altre specifiche di controllo del 
programma di utilità. 


| programmi di utilità SSP che è possibile usare per ciascuna procedura SSP, 
sono descritti nell’Appendice A, Specifiche di controllo dei programmi di utili- 
tà delle procedure SSP. 


COMANDI DI CONTROLLO 
} comandi di controllo sono usati per controllare il sistema, le stampatrici e le 
unità video. L'esempio che segue mostra come è possibile interrompere fa stampa 


di un'emissione di stampa differita sulla stampatrice P3: 


STOP PRT,P3 


Vedere il Capitolo 6 Comandi di controllo per le descrizioni dettagliate dei co- 


mandi di controlio. 


INFORMAZIONI CONCETTUALI E CONSIDERAZIONI DI PROGRAM- 
MAZIONE 


Per quanto riguarda le informazioni introduttive relative ai computer, vedere il 
manuale Learning about Your Computer. Per informazioni relative ai concetti di 
sistema e alle tecniche di programmazione, vedere manuale Concepts and Pro- 


grammaer's Guide. 


CONVENZIONI USATE PER DESCRIVERE 1 FORMATI DI SINTASSI 


Quando in questo manuale vengono presentati i formati di sintassi, le espressioni 
in maiuscolo, le parentesi quadre, le parentesi graffe, le parentesi tonde e le sot- 
tolineature, hanno significati speciali. 


Espressioni in maiuscolo 


Le espressioni maiuscole devono essere immesse così come sono indicate nei for- 
mati di sintassi. | numeri e i caratteri speciali nell’ambito di espressioni maiuscole 
a loro volta devono essere immessi come sono indicati. Un’espressione non in ma- 
iuscolo deve essere sostituita con un valore appropriato. Per esempio: 


// FORMS LINES-valore 





potrebbe essere codificato: 


// FORMS LINES-66 
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Parentesi graffe { } 


Le parentesi graffe in un formato di sintassi, non sono codificate come parte del 
comando o della specifica. Le parentesi graffe indicano che uno dei valori da esse 
racchiuso deve essere codificato. ©’ 

Per esempio: 





indica che se si sceglie di codificare una data, questa deve essere in uno dei tre 
formati indicati: mmggaa, ggmmaa o aammgg. Per esempio 14 Aprile 1983 po- 
trebbe essere immesso nella forma: 041483 (mmggaa), 140483 {ggmmaa) o 


830414 (aammgg). 


Parentesi quadre [ |] 


Le parentesi quadre in un formato di sintassi non sono codificate come parte del 
comando o della specifica. Le parentesi quadre indicano che l’espressione da esse 
racchiusa è facoltativa. Se tra parentesi quadra è inclusa una lista di valori, è pos- 
sibile scegliere di non codificare un valore o di codificare uno dei valori della lista. 


Per esempio: 


id dello schermo | ,testo del messaggio 


id dell'utente 
ALL 





indica che non occorre codificare il primo parametro ma se si decide di farlo, 
questo deve essere in uno dei tre formati: 


e UnID dello schermo 
e UniD dell'utente 
e La parola ALL 


Per esempio è possibile immettere: 


MSG ALL,THE SYSTEM WILL SHUT DOWN IN 10 MINUTES 


gr 


STATUS 
(D) 


OFF 


Parentesi tonde ( ) 


Le parentesi tonde in un formato di sintassi non sono cadificate come parte del 
comando o della specifica. Le parentesi indicano che il valore racchiuso tra di 
esse è un’abbreviazione che può essere immessa in luogo dei caratteri al di sopra 


delie parentesi. Per esempio: 


SESSION 
(S) 


indica che è possibile immettere STATUS SESSION in una delle seguenti forme: 


STATUS SESSION 
DS 

STATUS S 

D SESSION 


Sottolineatura 
La sottolineatura identifica i valori assunti per difetto. ll sistema usa automati- 
camente il valore assunto per difetto se non sì codifica un valore facoltativo. 


Per esempio: 


DROP 
HOLD 


indica che il sistema assume DROP se non si codifica il parametro. (Ricordarsi 
che le parentesi quadre indicano che il parametro è facoltativo). 
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Virgole 


I formati di sintassi spesso indicano la necessità di virgole, cioè quando le virgole 
non sono tra parentesi quadre. Le virgole compaiono all’esterno delle parentesi 
quadre per ricordare che se viene omesso un parametro, deve essere immessa una 
virgola per indicare la posizione del parametro omesso (quando uno o più para- 
metri sono codificati nelle posizioni che seguono il parametro omesso). 

Per esempio: 






RESTART PRT, |id stampatrice | »s | numero pagina 
PAGE 





indica che se il secondo parametro non è codificato ma lo è il terzo, occorre co- 
dificare una virgola per indicare il posto del parametro mancante, come segue: 


RESTART PRT,,PAGE 
Per qualsiasi procedura o comando di controllo che si immette, le virgole che se- 
guono l’ultimo parametro codificato, sono facoltative. 


Per esempio: 


RESTART PRT,, 


RESTART PRT 


sono trattati analogamente. 


Esempio di diagramma di sintassi 


Il seguente diagramma di sintassi mostra come possono essere combinati questi 
metodi di rappresentazione: 


// ALLOCATE UNIT- i O sWAIT-fNO 
NO YES YES 





Per allocare l’unità 11 con CONTINUE come YES e WAIT come NO, è possibile 
immettere: 


// ALLOCATE UNIT-Il,CONTINUE-YES,WAIT-NO 


Notare che NO è il valore assunto per difetto per il parametro WAIT cosicché si 
sarebbe potuto immettere quanto segue: 


// ALLOCATE UNIT-I1,CONTINUE-YES 


e i risultati sarebbero stati gli stessi. 
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GUIDA ALL'USO DEL SUPPORTO DI SISTEMA 


Questo capitolo elenca ie funzioni che è possibile eseguire usando il Sistema/36. 
Sono elencate le procedure e i comandiLle le specifiche OCL che si possono uti- 
lizzare per eseguire ciascuna funzione. Queste funzioni sono distinte nei seguenti 


gruppi: 


e Creazione e aggiornamento dei file su disco. 


e Creazione e aggiornamento di librerie. 


‘@ Creazione e aggiornamento cartelle e membri di cartelle. 


e Elaborazione di minidischi. S 
e Elaborazione di minidischi. 
e Elaborazione.dì nastri. 


e Creazione e aggiornamento dei tracciati video, dei menù e dei membri di 
messaggi. 


e Creazione e aggiornamento di programmi. 
® Utilizzo prodotti per ufficio. 
e. Esecuzione di programmi e procedure. 
e Modifiche e controllo di stampanti, lavori e unità video. 
e Definizione del sistema e dei suoi utenti. 
sia \ Sr y 
e Comunicazione con altri sistemi. 


CI Aggiornamento del sistema. 
e Definizione e correzione di problemi. 


Quando ci si collega al Sistema/36 è possibile usare il supporto dei testi esplicati- 
vi per facilitare l'esecuzione di una funzione. ll supporto dei testi esplicativi è co- 
stituito da menù, schermi di richiesta e testo esplicativo. | menù consentono di 


scegliere la funzione da eseguire. Quando si sceglie un'opzione da un menù: 
| 


e Viene visualizzato un altro menù (quando si scelgono Id opzioni, ciascuna di 
esse fornisce ulteriori particolari sulla funzione che si vuole eseguire) 


e Oppure viene presentato uno schermo di richiesta per una procedura o per 
un comando. 


Uno schermo di richiesta consente di immettere i parametri necessari e quindi 
eseguire un comando o procedura per eseguire la funzione. Il testo esplicativo 
spiega i menù, le opzioni dei menù, le procedure, i comandi e i parametri per ie 
procedure e i comandi. 


Per ulteriori informazioni sul supporto di testi esplicativi vedere la Procedura 
HELP. 
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Creazione e aggiornamento di file su disco 


Modifica 
Per modificare le informazioni in un file su disco usando il DFU, vedere la 
Procedura UPDATE . 


Per usare un file in un programma, vedere la Specifica OCL FILE (per i file su 
disco). 


Compressione 
Per compiere lo spazio su disco e cioè raccogliere tutto lo spazio libero sul 


disco in una sola area, vedere la Procedura COMPRESS.. 


Copia 
Per copiare un file su disco ed eseguire una o più delle funzioni seguenti: 


Creazione di un nuovo file su disco con la stessa organizzazione di file 
Creazione di un nuovo file su disco con una diversa organizzazione di file 
Modifica della lunghezza di record di un file 

Modifica della posizione e della lunghezza delle chiavi in un file a indice 
Inclusione di record specifici in un nuovo file 

Omissione di record specifici da un nuovo file 

Rimozione di record cancellati da un file 


Vedere la Procedura COPYDATA . 


Per aggiungere un file su disco a un file esistente su minidisco, vedere la Pro- 
cedura SAVE . 


Per creare o copiare un file su minidisco in formato base di interscambio o 
in formato scambio di tipo | (per trasferire un file ad un altro sistema) vede- 
re la Procedura TRANSFER. 


Per copiare un file su disco su nastro (per trasferire un file ad un altro siste- 
ma) o per copiare un file su nastro su disco, vedere la Procedura TAPECOPY. 


Per copiare un file su minidisco creato da IBM 5260 Retail System (formato 
speciale E) su un file su disco, vedere la Procedura POST. 


Per copiare il file storico cronologico su un file disco, vedere la Procedura 
HISTORY. 


Per copiare un elemento di un file di stampa differita su un file su disco, ve- 
dere la Procedura COPYPRT. 


Per copiare un file di transazione WSU su un file su disco e includere o 
omettere record specifici, vedere la Procedura WSUTXEX . 


Creazione 
Per creare un file su disco vuoto, vedere la Procedura BLDFILE. 


Per creare un file su disco e immettere record nel file usando il DFU, vedere 
la Procedura ENTER. 


Per creare o usare un file in un programma, vedere la Specifica OCL FILE 
(per file su disco). 


Per creare un indice alternativo per un file su disco esistente, vedere la Proce- 


dura BLDINDEX . 


Organizzazione 
Vedere la Procedura COPYDATA . 


Stampa, visualizzazione 
Per stampare o visualizzare i contenuti di un file su disco, vedere la Procedu- 


ra LISTDATA o la Procedura LISTFILE. 


Per stampare o visualizzare i nomi di tutti i file su disco, su minidisco, su un 
nastro o nastro a cassetta, vedere la Procedura CATALOG. 


Per stampare o visualizzare un file o una libreria salvata su minidisco, nastro 
o nastro a cassetta, vedere la Procedura LISTDATA o la Procedura LISTFILE. 


Per stampare o visualizzare il file storico cronologico, vedere la Procedura 
HISTORY . 


Per stampare o visualizzare i contenuti di un file usando il DFU, vedere la 
Procedura LIST. 


Per copiare un elemento di un file di stampa differita su un file su disco e 
quindi visualizzare quel file su disco, vedere la Procedura COPYPRAT . 


Rimozione 
Per rimuovere un file da un disco o da un minidisco, vedere la Procedura 


DELETE . 


Per copiare un file su disco e rimuovere i record cancellati dal file, vedere la 
Procedura COPYDATA . 


Ridenominazione 
Per ridenominare un file su disco, vedere la Procedura RENAME . 


Salvataggio 
Per salvare su minidisco, nastro o nastro a cassetta uno o più file disco vedere 


la Procedura SAVE. 


Per aggiungere un file su disco ad un file esistente su un minidisco, vedere la 
Procedura SAVE. 


Ripristino 
Per ripristinare su disco uno o più file su minidisco, su nastro o nastro a casset- 
ta, vedere la Procedura RESTORE. 


Protezione 
Per garantire a un file su disco la lettura, la modifica, la creazione o la rimo- 


zione, soltanto da parte di taluni operatori, vedere ia Procedura SECDEF e 
la Procedura SECEDIT. 


Selezione 
Per selezionare i contenuti di un file su disco, vedere la Procedura SORT. 


Per selezionare le chiavi per l'indice di un file a indice, vedere la Procedura 
KEYSORT. 
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Creazione e gestione di librerie 


Modifiche E 
Per modificare la dimensione di una libreria o di un indirizzario di libreria, 


vedere la Procedura ALOCLIBR . 


Per modificare un membro di libreria usando il SEU, vedere ia Procedura 
SEU. 


Per modificare i tracciati video o menù usando lo SDA, vedere la Procedura 
SDA. 


Per modificare la libreria corrente sull'unità video, vedere la Procedura SLIB. 


Per modificare ia libreria di collegamento per l'unità video, vedere la Proce- 
dura SET. 


Per modificare il nome, il sottotipo o ii numero di riferimento di un membro 
di libreria, vedere la Procedura CHNGEMEM, 


Condensazione 
Per condensare una libreria e cioè per raccogliere tutto lo spazio libero in 
una libreria in una sola area, vedere la Procedura CONDENSE. 


Copia 
Per copiare uno o più membri di libreria da una libreria in un’altra, vedere la 
Procedura LIBRLIBR. 


Per copiare uno o più membri di libreria su un file su disco, su minidisco, st: 
nastro o nastro a cassetta, vedere la Procedura FROMLIBA. 


Per copiare un membro di libreria in un file su minidisco in formato base 
d'interscambio, per trasferire il membro di libreria ad un altro sistema, vede- 
re le Specifiche Procedura FROMLIBR: Programma di utilità $SMAINT. 


Per copiare in una libreria un file su disco, su minidisco, su nastro o nastro a 
cassetta contenente uno o più membri di libreria, vedere la Procedura TOLIBR. 


Creazione 
Per creare una nuova libreria, vedere la Procedura BLDLIBR. 


Per creare una nuova libreria e per copiare membri nella nuova libreria, vede- 
re la Procedura BLDLIBR. 


Per creare una nuova procedura o-membro origine in una libreria, usando il 
SEU, vedere la Procedura SEU. 


Per creare tracciati video o menù usando lo SDA, vedere la Procedura SDA . 


Stampa, visualizzazione 
Per stampare o visualizzare i nomi dei membri in una libreria oppure per li- 
stare i contenuti di uno o più membri di libreria, vedere la Procedura LIST- 
LIBRA. 


Per stampare o visualizzare i nomi di tutte le librerie su un disco, su un minidi- 
sco, su un nastro o nastro a cassetta, vedere la Procedura CATALOG. 


Per stampare o visualizzare i nomi dei membri di una libreria salvata su minidi- 
sco, su nastro o nastro a cassetta, vedere la Procedura LISTFILE. 


Rimozione 
Per rimuovere una libreria da disco o da un minidisco, vedere la Procedura 


DELETE. 


Per rimuovere uno o più membri da una libreria, vedere la Procedura 
REMOVE. 


Per rimuovere un’estensoine di libreria vedere la Procedura ALOCLIBR o 
la Procedura CONDENSE. 


Per rimuovere un tracciato video da un membro di tracciati video, vedere la 
Procedura FORMAT oppure la Procedura SDA. 


Ridenominazione 
Per ridenominare una libreria, vedere la Procedura RENAME. 


Per ridenominare un membro di libreria, vedere la Procedura CANGEMEM. 


Salvataggio 
Per salvare una libreria su minidisco, nastro o nastro a cassetta, vedere la Pro- 


cedura SAVELIBR. 


Ripristino 
Per ripristinare su disco una libreria da minidisco, da nastro o nastro a casset- 
ta, vedere la Procedura RESTLIBR. 


Protezione 
Per garantire a una libreria la lettura, la modifica, la creazione o la rimazio- 
ne, soltanto da parte di taluni operatori, vedere la Procedura SECDEF e la 
Procedura SECEDIT. 


Aggiornamento cartelle e membri di cartelle 


Aggiornamento 
Per variare l'ampiezza di una cartella, vedere la procedura ALOCFLDR 


Compressione 
Per comprimere una cartella, che vuoi dire raccogliere tutto lo spazio libero in 
una stessa area, vedere la procedura CONDENSE. 


Copia 
Per copiare una cartella su minidisco, nastro o nastro a cassetta, vedere ia Pro- 
cedura SAVEFLDR. Per copiare un membro di cartella su minidisco, nastro o 
nastro a cassetta, vedere la Procedura ARCHIVE. 


Creazione 
Per creare o aggiornare una cartella, vedere la procedura TEXTFLDR. 
Per creare o aggiornare un membro di cartella, vedere la procedura TEXTDOC. 


Stampa visualizzazione 
Per stampare o visualizzare i dati di un membro di cartella, vedere la procedura 
LISTFILE. 


Per stampare o visualizzare i nomi di tutte le cartelle su disco, minidisco, o na- 
stro a cassetta, vedere la Procedura CATALOG. 


Cancellazione 
Per cancellare una cartella da disco, vedere la procedura DELETE. 


Ridenominazione 
Per ridenominare una cartella, vedere la procedura RENAME 
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Riorganizzazione 
Per riorganizzare una cartella, vedere le procedure ALOCFLDR e CONDENSE. 


Ripristino 
| Per ripristinare una cartella da minidisco, nastro o nastro a cassetta, vedere 
la Procedura RESTFLDR. Per ripristinare un membro di libreria da minidisco, na- 


stro o nastro a cassetta, vedere la Procedura RETRIEVE. 


Salvataggio 
| Per salvare una cartella su minidisco, nastro o nastro a cassetta, vedere la Pro- 


cedura SAVEFLDR. Per salvare un membro di cartella su minidisco, nastro o 
nastro a cassetta, vedere la Procedura ARCHIVE. 


Protezione 
Per garantire a una cartella, la lettura, la modifica, la creazione, o la rimozione, 
soltanto da parte di alcuni operatori, vedere ie procedure SECDEF e SECEDIT. 


Elaborazione di minidischi 


Allocazione 
Per allocare un modulo a minidischi ad un lavoro, vedere la Procedura OCL 


ALLOCATE. 
Per disallocare il modulo a minidischi, vedere la Specifica OCL DEALLOC. 


Copia 
Per copiare tutto o parte di un minidisco su un altro minidisco, vedere la 
Procedura COPYII1. 


| Per copiare su minidisco diagnostico vedere Procedura COPYDIAG. 


Per creare o copiare un file su minidisco in formato | o in formato base di 
interscambio, vedere la Procedura TRANSFER. 


Per copiare un minidisco creato da IBM 5260 Retail System (formato specia- 
le E} su un file su disco, vedere la Procedura POST. 


Per copiare in una libreria un file minidisco contenente uno o più membri di 
libreria, vedere la Procedura TOLIBR. 


Per copiare uno o più membri di libreria da una libreria su minidisco, vedere 
la Procedura FROMLIBR. 


Preparazione 
Per preparare (ossia per inizializzare) un minidisco prima di usarlo per salvare 
i dati, vedere la Procedura INIT. 


| Per preparare un minidisco diagnostico vedere Procedura INITDIAG. 


Stampa, visualizzazione 
Per listare i nomi dei file, delle librerie e delle cartelle contenute su un minidi- 
sco, oppure per listare informazioni generali relative ad un minidisco, vedere 
la Procedura CATALOG. 


Per listare un file salvato su minidisco, vedere la Procedura LISTDATA o la Proce- 
dura LISTFILE. 


Per listare una libreria salvata su un minidisco, oppure per listare un file su 
mininidisco in formato d'interscambio, vedere la Procedura LISTFILE, 


Rimozione 
Per rimuovere uno o più file o librerie da minidisco, vedere la Procedura 


DELETE. 


Salvataggio 
Per salvare uno o più file su disco su minidisco, vedere la Procedura SAVE. 


Per salvare una cartella su minidisco vedere la Procedura SAVEFLDA. 
Per salvare una libreria su minidisco, vedere la Procedura SAVELIBR. 


Ripristino 
Per ripristinare di nuovo su disco uno o più file salvati su minidisco, vedere la 
Procedura RESTORE. 


Per ripristinare una libreria da minidisco a disco, vedere la Procedura RESTLIBR. 
Per ripristinare una cartella da minidisco vedere la Procedura RESTFLDR. 


Per ripristinare un membro di cartella da minidisco vedere la Procedura 
RETRIEVE. 


Elaborazione di nastri 


Aillocazione 
Per allocare l’unità a nastro ad un lavoro, vedere la Specifica OCL ALLO- 


CATE. 


Per disallocare l’unità a nastro, vedere ia Specifica OCL DEALLOC. 


Copia 
Per creare o copiare un file su nastro in formato interscambio, vedere la 
Procedura TAPECOPY. 


Per copiare in una libreria un file nastro che contiene uno o più membri di 
libreria, vedere la Procedura TOLIBR. Per copiare su nastro da una libreria 
uno o più membri di libreria, vedere la Procedura FROMLIBA. 


Preparazione 
Per preparare (ossia inizializzare) un nastro o nastro a cassetta prima di usarlo 
per salvare i dati, vedere la Procedura TAPEINIT. 


Stampa, visualizzazione . 
Per listare i nomi dei file, librerie e cartelle contenuti su un nastro o nastro a 
cassetta, oppure per listare informazioni generali relative ad un nastro, vedere 
la Procedura CATALOG. 


Per listare un file salvato su un nastro o nastro a cassetta, vedere la Procedura 
LISTDATA o la Procedura LISTFILE. 


Per listare una libreria salvata su un nastro o nastro a cassetta oppure per lista- 
re un file su nastro in formato interscambio, vedere ia Procedura LISTFILE. 


Ripristino 
Per ripristinare di nuovo su disco uno o più file salvati su nastro o nastro a cas- 
setta, vedere la Procedura RESTORE. 


Per ripristinare una cartella da nastro o nastro a cassetta, vedere la Procedura 
RESTFLDR. 


Per ripristinare un membro di cartella da nastro o nastro a cassetta, vedere la 
Procedura RETRIEVE. 
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Per ripristinare su disco una libreria da nastro o nastro a cassetta, vedere la Proce- 
dura RESTLIBR. 


Salvataggio sa 
Per salvare uno o più file su disco su un nastro o su nastro a cassetta, vedere : 
la Procedura SAVE. 


Per salvare una cartella su nastro o nastro a cassetta, vedere la Procedura 
SA VEFLDR. 


Per salvare un membro di cartella su nastro o nastro a cassetta, vedere la Pro- 
cedura SAVEFLDR. 
Creazione e gestione di tracciati video, menù e membri di messaggi 
Tracciati video 
Per creare, modificare e generare tracciati video usando lo SDA, vedere la 


Procedura SDA . 


Per generare soltanto tracciati video da specifiche origine, vedere la Procedu- 
ra FORMAT. 


Per rimuovere un tracciato video da un membro oggetto tracciati video, 
vedere la Procedura SDA oppure ia Procedura FORMAT. 


Menù 
Per modificare o creare un menù usando lo SDA, vedere la Procedura SDA. 


Per generare un menù da specifiche origine, vedere la Procedura BLDMENU. 
Per visualizzare un menù, vedere il Comando di controllo MENU, 

Membri di messaggi 
Per generare un membro di messaggi da specifiche origine, vedere la Procedu- 


ra CREATE. 


Per creare o modificare i valori di risposta automatica per membri di messag- 
gi di sistema o dell'utente, vedere la Procedura RESPONSE. 


Per assegnare un membro di messaggi ad una procedura o ad un programma, 
vedere la Specifica OCL MEMBER. 


Creazione e gestione di programmi 


Assembler 
Per assemblare un programma assembler, vedere la Procedura ASM. 


Per creare o modificare un programma assembler, vedere la Procedura SEU. 
BASIC 

Per creare, modificare, eseguire e correggere gli errori di un programma 

BASIC, vedere la Procedura BASIC. 

Per eseguire un programma BASIC, vedere la Procedura BASICAR. 

Per eseguire una procedura BASIC, vedere la Procedura BASICP. 


Per convertire un membro origine BASIC in un membro di sottoroutine 
BASIC, vedere la Procedura BASICS. a 


BGU 


Per modificare i modelli ed i colori da utilizzarsi con il BGU/36, vedere la Proce- 
dura BGUATTR. 


Per copiare un file di immissione dati grafici (GDIF) in un membro dati su una 
libreria utente, vedere la Procedura BGUDATA. 


Per creare, aggiornare, stampare, tracciare, o visualizzare un diagramma, ve- 
dere la Procedura BGUCHART. 


Per creare, aggiornare, stampare, tracciare, o visualizzare un grafico, vedere 
la Procedura BGUGRAPH. 


RPG Ii 


Per visualizzare un menù di opzioni di programmazione RPG II, vedere la 
Procedura RPGP. 


Per creare un programma RPG ll e quindi compilare e alternativamente cor- 


reggere errori in linea sul programma origine (sull'unità video), vedere la Pro- 
cedura RPGONL. 


Per compilare un programma origine RPG Il, vedere la Procedura RPGC. 


Per compilare un programma origine RPG Il che contiene specifiche di auto- 
report, vedere la Procedura AUTOC. 


Per creare o modificare una procedura su un membro origine autoreport o 
RPG Il, vedere la Procedura RPGSEU. 


Per creare una lista di riferimenti incrociati di un programma RPG Il, vedere la 
Procedura RPGX. 


Per creare o modificare tracciati video per un programma RPG, vedere la Pro- 
cedura RPGSDA. 


Per creare tracciati video per un. file RPG Il CONSOLE, vedere ia Procedura 
RPGAR. 


COBOL 


Per visualizzare un menù delle opzioni di programmazione COBOL, vedere ia 
Procedura COBOLP. 


Per creare un programma COBOL e quindi compilare e alternativamente cor- 
reggere errori in linea nel programma origine (sull'unità video), vedere la 
Procedura COBOLONL. ò 


Per compilare un programma origine COBOL, vedere la Procedura COBOLC. 


Per compilare o modificare una procedura o un membro origine COBOL, 
vedere la Procedura COBSEU . 


Per creare o modificare tracciati video per un programma COBOL, vedere la 
Procedura COBSDA. 
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FORTRAN 
Per visualizzare un menù di opzioni di programmazione FORTRAN, vedere 


la Procedura FORTP. 


Per creare un programma FORTRAN e quindi compilare e alternativamente 
correggere errori in linea nel programma origine (sull'unità video), vedere la 
Procedura FORTONL. 


Per compilare un programma origine FORTRAN, vedere la Procedura FORT- 
RANC. 


Per eseguire un programma FORTRAN, vedere la Procedura FORTGO. 


Per creare o modificare una procedura o un membro origine FORTRAN ve- 
dere la Procedura FORTSEU. 


Per creare o modificare tracciati video per un programma FORTRAN, vedere 
la Procedura FORTSDA. 


Concatenamento di moduli oggetto 
Per concatenare uno o più membri di sottoroutine in un programma che può 
essere eseguito, vedere la Procedura OLINK. 


WSU 
Per generare un programma di utilità per terminale (WSU) da specifiche ori- 
gine, vedere la Procedura WSU . 





Per creare o modificare l'origine per un programma WSU, vedere la Procedu- 
ra SEU. 


Utilizzo prodotti per ufficio 


Personal Services/36 (PS/36) 
Per modificare i valori assunti automaticamente, vedere la procedura OFCDFLT. 
Per controllare l’attività e le code di comunicazione, vedere la procedura OFCO. 
Per creare o aggiornare un calendario, vedere la procedura OFCAL. Per imma- 
tricolare o modificare l'iscrizione degli utenti PS/36, vedere la procedura 
OFCUSER. 
Per installare i file PS/36, vedere la procedura OFCINSTL. Per aggiornare l’in- 
formazione d'ufficio, vedere la procedura OFCMAINT. Per riorganizzare o sal- 
vare l'informazione, vedere la procedura OFCDATA. 
Per richiedere la stampa o la cancellazione di voci di un elenco, vedere la pro- 
cedura OFCBPRAT. 
Per scegliere diversi modi di vedere l’indirizzario, vedere la procedura OFCDIR. 
Per mandare messaggi, vedere la procedura OFCMSFG. 
Per gestire la posta, vedere la procedura OFCMAIL. 
Per gestire un gruppo di utenti, vedere la Procedura OFCGRP. 


Query/36 
Per definire una QUERY o lavorare con una QUERY già definita, vedere la procedu- 
ra ORY. 
Per eseguire una QUERY e visualizzare, stampare o inviare su disco il dato prodot- 
to, vedere la procedura ORYRUN. 
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Displaywrite/36 (DW/36) 
Per convertire un documento creato dal TEXT MANAGEMENT SYSTEM (TMS) 
in uno DW/36, vedere la procedura TEXTCONV. 
Per creare o aggiornare una cartella vedere la procedura TEXTFLDA. Per creare 
o aggiornare un membro di cartella, vedere la procedura TEXTDOC. Per visua- 
lizzare un documento in linea nella sua forma finale, vedere la procedura 
READINFO. 
Per aggiornare un indirizzario suppiementare, vedere la procedura TEXTDCT. 
Per rilasciare documenti che erano stati in precedenza congelati, vedere la pro- 
cedura TEXTREL. 


Definizione dati nei file. 


Programma di utilità definizione interattiva dati {IDDU). 
Per collegare o scollegare un file su disco, o per immettere o aggiornare un da- 
to su un file su disco, o per creare un file su disco, vedere la procedura 
IDDUDISK. 


Per creare o aggiornare una definizione, vedere la procedura IDDUDFN. Per creare 
o aggiornare un dizionario, vedere la procedura IDDUDCT. Per collegare o scol- 
legare una definizione di file con un file su disco, vedere la procedura IDDULINK. 
Per stampare un campo, un formato o una definizione di file in un dizionario, 
vedere la procedura IDDUPRT. 

Per trasferire le specifiche origine RPG contenute in un programma origine RPG 
o in una definizione TMS (TEXT MANAGEMENT SYSTEM) in una definizione 
IDDU, vedere la procedura /DDUXLAT. 
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Esecuzione di programmi e di procedure 


Data 
Per modificare la data di un programma, di un lavoro o di un passo di lavoro, 
vedere la Specifica OCL DATE oppure la Procedura DATE, 


File di dati 
fer usare un file di dati in un programma, vedere la Specifica OCL FILE 


(per il file su disco). 


Per riservare spazio su disco per file di dati di lavoro e temporanei, vedere la 
Specifica OCL RESERVE. 


Tracciati video 
Per presentare un tracciato video da una procedura che richiede parametri o 
dati, vedere la Specifica OCL PROMPT. 


Unità video i 
Per assegnare una unità video ad un programma, vedere la Specifica OCL 
WORKSTN . 


Area dati locale 
Per modificare le informazioni in un'area dati locale vedere la Specifica OCL 
LOCAL. ì 


Per passare informazioni dall'area dati locale a una procedura, vedere l'’Espres- 
sione ?L° posizione,lunghezza’? (Local Data Area). 


Menù 
Per visualizzare e usare un menù, vedere il Comando di controllo MENU o la 
Specifica OCL MENU. 


Messaggi 
Per assegnare un membro di messaggi. ad un programma o ad una procedura, 
vedere la Specifica OCL MEMBER. 


Per trasmettere un messaggio ad un operatore, vedere: 


Il Comando di controllo MSG. 

La specifica //*(Messaggio informativo). 

La specifica PAUSE. 

La procedura ERR. 

La specifica //** (Messaggio di console di sistema) . 
La specifica OCL MSG. 


Per specificare se i messaggi informativi devono essere visualizzati, vedere la 
Specifica OCL INFOMSG . 


Per modificare il livello di risposta automatica per un programma o una pro- 
cedura, vedere la Specifica OCL NOHALT. 


Per definire, listare e rimuovere messaggi dal file dei messaggi, vedere la proce- 
dura MSGFILE. 


Stampatrici 


Per usare una stampatrice in un programma, vedere ia Specifica OCL PRIN- 
TER. 


Per modificare uno o più degli elementi che seguono, vedere la Procedura 
PRINT, \a Procedura SET oppure la Specifica OCL FORMS: 


La stampatrice da usare 

{l numero di righe per pagina 

Il numero di caratteri per pollice (CPI) stampati orizzontalmente 
il numero di righe per pollice (LP1) stampate verticalmente 

Il numero di codice del modulo da usare 


Per modificare l’unità di lista corrente del sistema, vedere la Procedura SYS- 
LIST oppure la Specifica OCL SYSLIST. 


Per modificare la stampatrice usata per l'emissione del tasto Stampa e per 
specificare se deve essere stampato un margine o un testo fisso superiore con 
l'emissione del tasto Stampa, vedere la Procedura PRINTKEY, la Procedura 
SET o la Specifica OCL WORKSTN. 


Priorità 
Per modificare ia priorità di elaborazione di un lavoro, vedere il Comando 
di controllo PRTY oppure la Specifica OCL ATTA. 


Dimensioni del programma 
Per specificare di quanta memoria ha bisogno un programma per l’esecuzio- 
ne, vedere la Specifica OCL REGION. ° 


Ripartenza 
Per consentire l'esecuzione di lavori sul sistema dopo l'immissione di un co- 
mando STOP, vedere il Comando di controllo START. 


Per rilasciare uno o più lavori congelati nella coda dei lavori in modo che 
possano essere eseguiti, vedere il Comando di controllo RELEASE. 


Avviamento 
Per visualizzare lo stato corrente dei programmi e delle procedure in esecuzio- 
ne, usare il Comando di controllo STATUS USERS e STATUSF USER. 


Per caricare ed eseguire un programma compilato, vedere la Specifica OCL 
LOAD e la Specifica OCL RUN. 


Per avviare una procedura vedere: 
La specifica OCL INCLUDE 
Il comando di controllo JOBQ 
La specifica OCL JOBOQ 
La specifica OCL EVOKE 


Per avviare un lavoro da un flusso dei lavori, vedere la Procedura JOBSTR. 


31 


32 


Arresto 
Per interrompere un lavoro attualmente in esecuzione, vedere il Comando di 
controllo CANCEL. 


Per evitare l'esecuzione di qualsiasi lavoro, vedere il Comando di controllo 


STOP. 
Per congelare uno o più lavori nella coda dei lavori, vedere il Comando di 
controllo HOLD. È 

Interruttori 


Gli interruttori sono anche detti indicatori esterni, da U1 a U8. 


Per modificare l'impostazione degli indicatori esterni, vedere la Specifica 
OCL SWITCH. 


Per controllare l'impostazione degli indicatori esterni in una procedura, vede- 
re la sezione Espressioni sostitutive. 


Attesa 
Per attendere un intervallo di tempo specificato oppure per attendere fino 
ad una certa ora prima dell'inizio di un lavoro, vedere la Specifica OCL 
WAIT. 


Modifiche e controllo di stampatrici, lavori e unità video 


Per visualizzare informazioni sull'ambiente delle unità video, vedere il Comando di 
controllo STATUS, o il comando STATUSF. 


Dati visualizzati 
Per visualizzare l’unità di lista corrente del sistema, usare il Comando di con- 
trollo STATUS SESSION. 


Per modificare l’unità di lista corrente del sistema, vedere la Procedura SYS- 
LIST oppure la Specifica OCL SYSLIST. 


Coda dei lavori 
Per visualizzare lo stato della coda dei lavori, usare il Comando di controllo STA- 
TUS JOBO o STATUSF. 


Per inserire un lavoro nella coda dei lavori vedere il Comando di controllo 
JOBO o la Specifica OCL JOBOQ. 


Per modificare il numero di lavori a cui è consentito di essere elaborati dalia 
coda lavori, vedere il Comando di controllo CHANGE. 


Per modificare la posizione di un lavoro nella coda dei lavori, vedere il Co- 
mando di controllo CHANGE . 


Per impedire l'esecuzione di uno o più lavori nella coda dei lavori, vedere il 
Comando di controllo HOLD. 


Per consentire l'esecuzione di uno o più lavori congelati nella coda dei lavori, 
vedere il Comando di controllo RELEASE. 


Per interrompere la coda dei lavori o una specifica priorità di coda lavori, 
vedere il Comando di controllo STOP. 


Per avviare la coda dei lavori o una specifica priorità di coda lavori, vedere il 
Comando di controllo START. 


Lavori 
Per visualizzare lo stato dei programmi e delle procedure che vengono eseguito 


sul sistema, usare il Comando di controllo STATUS USERS o STATUSF USER. 


Per avviare un lavoro vedere: 


La specifica OCL INCLUDE 

Il comando di controllo JOBO 
La specifica OCL JOBO 

La specifica OCL EVOKE 


Per cancellare un lavoro, vedere il Comando di controllo CANCEL. 


Per evitare che i lavori vengano eseguiti sul sistema, vedere il Comando di 
controllo STOP. 


Per consentire l'esecuzione dei lavori sui sistema, vedere il Comando di con- 
trollo START. 


Per modificare la priorità di elaborazione di un lavoro in esecuzione sul si- 
stema o di un lavoro nella coda dei lavori, vedere il Comando di controllo 


PRTY. 


Librerie 
Per visualizzare ia libreria di sessione o quella corrente usare il Comando di 


controllo STATUS SESSION. A 


Per modificare la libreria di sessione o quella corrente, vedere Procedura 
SLIB o la Specifica OCL LIBRARY, 


Menù 
Per visualizzare un menù dell'utente, vedere Comando di controllo MENU 


oppure la Specifica OCL MENU. 


Per visualizzare un menù del supporto di testi esplicativi vedere la Procedura 
HELP. 


Messaggi 
Per specificare se devono essere visualizzati i messaggi informativi, vedere il 


Comando di controllo INFOMSG. i 


Per modificare il livello di risposta automatica per l’unità video, vedere la 
Procedura NOHALT. 


Per trasmettere un messaggio ad un’altra unità video oppure per visualizzare 
un messaggio trasmesso da un'altra unità video, vedere il Comando di con- 
trollo MSG. 


Per rispondere ad un messaggio visualizzato sulla console o sottoconsole di 
sistema, vedere il Comando di controllo REPLY. 


Spegnimento 
Per spegnere il sistema, vedere il Comando di controllo POWER o la Specifij- 
ca OCL POWER. 
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Dati stampati 


Per visualizzare lo stato dell'emissione stampata nel file per stampa differita, 
usare il Comando di controllo STATUS PRT o STATUSF PRT. 


Per visualizzare lo stato dei programmi di stampa differita, usare il Comando 
di controllo STATUS WRT.. 


Per modificare uno o più di quanto segue, vedere la Procedura PRINT, la Pro- 
cedura SET e la Specifica OCL FORMS. 


La stampatrice da usare 

Il numero di righe per pagina 

Il numero di caratteri per pollice (CPI) stampati orizzontalmente 
Il numero di righe per pollice (LPI) stampate verticalmente 

Il numero di codice del modulo da usare 


Per modificare l’unità di lista corrente del sistema, vedere la Procedura 
SYSLIST. 


Per modificare la stampatrice corrente o di collegamento, vedere la Procedura 
SET. 


Per modificare la stampatrice usata quando si preme il tasto Stampa e per spe- 
cificare se deve essere stampato un margine o un testo fisso, vedere la Procedu- 


ra PRINTKEY. 


Per avviare la stampa di un’emissione differita, vedere il Comando di control- 
lo START. 


Per interrompere la stampa di un’emissione differita, vedere il Comando di 
controllo STOP. 


Per riavviare la stampa di un’emissione differita, vedere il Comando di con- 
trollo RESTART. 


Per congelare un’emissione differita nel file di stampa differita per impedirne 
la stampa, vedere il Comando di controllo HOLD. 


Per rilasciare un'emissione differita congelata per la stampa, vedere il Co- 
mando di controllo RELEASE . 


Per modificare uno o più fra quanto segue: 


La posizione delle entrate nel file di stampa differita 

{Il numero delie copie da stampare 

Il numero di codice del modulo da usare 

La stampatrice da usare | 

Il numero delle pagine di separazione da stampare 

Se devono iniziare ad essere stampate entrate del file di stampa differita 
prima che vengano chiuse 

La priorità del programma di stampa differita 


vedere il Comando di controllo CHANGE, 


Per cancellare una o più entrate dal file di stampa differita, vedere il Coman- 
do di controllo CANCEL. 


Per modificare le immagini delle cinghie di stampa per la stampatrice 3262, 
vedere la Procedura SET o la Specifica OCL IMAGE. 


Caria 


Scollegamento 
Per scollegare l'unità video dal sistema, vedere il Comando di controllo OFF 
oppure la Specifica OCL OFF, 


Per scollegare un'altra unità video dal sistema, vedere il Comando di control 
lo CANCEL. 


Console di sistema 
Per trasferire la funzione di console di sistema ad un’altra unità video vedere 
il Comando di controllo CONSOLE. 


Per modificare gli ID di terminale di una o più stampatrici o unità video, 
vedere il Comando di controllo ASSIGN . 


Unità video di servizio di sistema 
Per consentire ad una unità video di venire usata per il servizio di sistema, 
vedere il Comando di controllo START. 


Per far cessare che una unità video venga usata per il servizio del sistema, 
vedere il Comando di controllo STOP. 


Definizione del sistema e dei suoi utenti 


Definizione 
Per configurare il sistema, vedere la Procedura CNFIGSSP. 


Per modificare la configurazione del sistema, vedere la Procedura CNFIG- 
SSP.. 


Per creare il file di ID dell'utente o per creare il file della riservatezza sulle 
risorse, vedere la Procedura SECDEF. 


Per immettere o modificare i dati nel file di ID dell'utente o del file di 
riservatezza sulle risorse, vedere la Procedura SECEDIT . 


Stampa, visualizzazione 
Per listare la configurazione del sistema, vedere la Procedura CNFIGSSP . 


Per listare il file di identificazione dell'utente o il file di riservatezza sulle ri- 
sorse, vedere la Procedura SECLIST . 


Salvataggio 
Per salvare il file di identificazione dell'utente o il file dî riservatezza sulle risor- 
se su minidisco, su nastro o nastro a cassetta, oppure per copiarli su file disco, ve- 
dere la Procedura SECSAVE. 


Ripristino 
Per ripristinare il file di identificazione dell'utente o il file di riservatezza sulle 
risorse da un file su minidisco, su nastro o nastro a cassetta, su disco, vedere 
la Procedura SECREST. 


Avviamento 
Per avere procedure che vengano eseguite automaticamente, immediatamente 
dopo l'avvio del sistema e cioè come parte del programma di caricamento ini- 
ziale (IPL) vedere la Procedura #STRTUPI e la Procedura #STRTUP2. 
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Comunicazioni con altri sistemi 


Comunicazione 
Per passare da un Sistema ad un Sistema/36 remoto e collegarsi da una sta- 
zione video come se questa fosse sul Sistema/36 remoto, vedere la Procedura 
PASSTHRU. 


Definizione 
Per impostare o configurare i sottosistemi Interactive comunications Feature 
(SSP-ICF), MSRJE o l'emulazione di unità 3270, vedere la Procedura 
CNFIGICF. 


Per definire la configurazione di rete, la configurazione dei canali logici e la 
configurazione di circuito virtuale, vedere Appendice G, Uso de/ Supporto 
X.25. 


Per visualizzare informazioni sul collegamento X.25 e per modificare taluni 
canali logici e le informazioni di configurazione di circuito virtuale, vedere 
l'Appendice G, Uso de/ Supporto X.25. 


Per impostare un'unità di controllo per il sottosistema SSP-ICF Finance, 
vedere la Procedura LOAD3601. 


Per creare o modificare la lista degli ID a distanza per una linea di comuni- 
cazione commutata che usa il sottosistema SSP-ICF BSCEL, vedere la Proce- 
dura DEFINEID. 


Per impostare le opzioni di configurazione delle comunicazioni, vedere la 


Procedura SETCOMM. 


Per creare o modificare un elenco telefonico per il dispositivo di chiamata 
automatica, vedere la Procedura DEFINEPN. 


Per creare o modificare una lista di numeri per il dispositivo X.21, vedere 
la Procedura DEFINX21. 


Per creare o modificare una lista di indirizzi di una rete a distanza usata per 
chiamata automatica per il dispositivo X.25, vedere l'Appendice G, Uso de/ 
Supporto X.25. 


Per avviare un sottosistema di comunicazioni SSP-ICF, MSRJE o l’emulazio- 
ne di unità 3270, vedere la Procedura ENABLE. 


Per interrompere un sottosistema di comunicazioni SSP-ICF, MSRJE o emu- 
lazione di unità 3270, vedere la Procedura ENABLE a pag. 000. 


Per interrompere un sottosistema di comunicazioni SSP-ICF, MSRJE o emu- 
lazione di unità 3270, vedere la Procedura DISABLE . 


Per porre in linea o fuori linea un terminale a distanza o una linea di comu- 
nicazioni, vedere il Comando di controllo VARY . 


Per modificare la configurazione di una linea di comunicazioni, vedere: 


La procedura ALTERCOM 
La procedura SETCOMM 
La specifica OCL COMM 
La specifica OCL SESSION 


Per avviare la funzione di autocontrollo per linee di comunicazione a deriva- 
zione multipla BSC, vedere la Procedura STARTM. 


Per interrompere la funzione di autocontrollo per linee di comunicazione a 
derivazione multipla BSC, vedere la Procedura STOPM. 


Su 


Per avviare una sezione di gruppo APPC, vedere la procedura STRTGRP. Per 
interrompere una sezione di gruppo APPC, vedere la procedura STOPGAP. Per 
specificare quali messaggi di sistema, dovranno dare segnali di avvertimento, 
vedere la procedura ALERT. 


Immissione di lavori a distanza 


Per eseguire l'immissione di lavori a distanza, vedere la Procedura MSRIJE . 


Per stampare le informazioni create da una funzione di immissione lavori a 
distanza, vedere la Procedura RIFILE. 


Per definire una tabella di controllo di immissione lavori a distanza, vedere 
la Procedura RJTABLE. 


Emulazione 3270 


Per eseguire un'emulazione di unità SNA 3270, vedere la Procedura ES3270. 


Per eseguire un'emulazione di unità BSC 3270, vedere la Procedura EM3270. 


Per collegare un PC IBM con emulazione unità SNA 3270, vedere la Procedura 
EP3270. 


Indirizzario risorse rete 


Per creare o stampare l’indirizzario risorse rete vedere la Procedura EDITNRD. 
Per listare il contenuto dell’indirizzario risorsa di rete, vedere la Procedura 
CATALOG. 

Per rimuavere l’indirizzario risorse rete dal disco, vedere la Procedura DELNRD. 
Per ripristinare l’indirizzario risorse rete da minidisco, nastro o nastro a casset- 
ta su disco, vedere la Procedura RESTNRAD. 

Per salvare l’indirizzario risorse rete su minidisco, nastro 0 nastro a cassetta, 
vedere la Procedura SAVENRD. 


Manutenzione del sistema 


Spazio su disco 


Per listare i contenuti del disco e le aree di spazio inutilizzato sul disco, ve- 
dere la Procedura CATALOG . 


Per riunire uno o più spazi inutilizzati tra i file su disco e librerie creando 
così spazio per altri file su disco e librerie, vedere la Procedura COMPRESS. 


Per riunire lo spazio inutilizzato in una libreria in una sola area creando così 
spazi per altri membri di libreria, vedere la Procedura CONDENSE . 


Per creare, modificare o cancellare la memoria di transito usata per conservare 
i dati su disco in memoria principale, vedere la Procedura CACHE. 


Cronologia 


Per stampare o visualizzare entrate di file storico, cronologico, vedere la Pro- 
cedura HISTORY. 


Per copiare il file storico, cronologico su un file su disco, vedere la Procedura 
HISTORY. 


Per eseguire una procedura quando il SSP crea automaticamente un file su 
disco denominato HISTCOPY (poiché il file storico, cronologico è pieno), ve- 
dere la Procedura HISTCOPY . 


Misura del sistema 


Per misurare l’attività del sistema, vedere la Procedura SMF . 


Per misurare l’attività delle linee di comunicazioni, vedere la Procedura 
STARTM o \a Procedura STOPM. 
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Definizione e correzione dei problemi 


Correzione 
Per avviare le procedure per la diagnostica in linea, vedere la Procedura 
PROBLEM. Vedere inoltre il manuale Diagnostica di Sistema per informazio- 
ni su ciò che è possibile fare prima di richiedere l'intervento del servizio tec- 
nico assistenza IBM. ° 


Ricerca e correzione degli errori 
Per far sì che ciascuna specifica di linguaggio controllo operativo (OCL) ela- 
borata in una procedura, venga registrata sul file storico, cronologico, vedere 
Specifica OCL LOG. 


Per far sì che tutte le valutazioni delle espressioni di controllo procedura 
vengano listate man mano che la procedura viene eseguita, vedere la Speci- 
fica OCL DEBUG. 


Per visualizzare o stampare il file storico, cronologico oppure per copiare 
il file storico, cronologico su un file su disco, vedere la Procedura HISTORY, 


File 
Per ricuperare un file che presenta un errore di disco permanente, vedere la 
Procedura BUILD . 


Sussidi di servizio 
Per eseguire le procedure e i programmi di sussidio di servizio, vedere la Pro- 
cedura SERVICE. ° 


Unità video di servizio di sistema 
Per far sì che una unità video venga usata come unità di servizio per il siste- 
ma, vedere il Comando di controllo START. 


Per far cessare che una unità video venga usata come unità di servizio per il 
sistema, vedere il Comando di controllo STOP. 


Capitolo 2. Creazione di proprie procedure 


Questo capitolo descrive come è possibile scrivere e usare proprie procedure. 


COS'E' UNA PROCEDURA 


Una procedura è una raccolta di specifiche che consentono che uno o più pro- 
grammi possano venir eseguiti. Le procedure consentono di evitare di dover im- 
mettere parecchie specifiche ogni volta che deve essere eseguito un lavoro, Una 
raccolta di specifiche è memorizzata in un membro di libreria detto membro di 


procedura. 


Lo scopo di una procedura è di eseguire un lavoro. La procedura può eseguire 
questo iavoro disponendo di uno o più passi di lavoro. Un passo di lavoro è una 
unità di lavoro eseguita da un programma. Un passo di lavoro solitamente inizia 
con una specifica OCL LOAD e solitamente termina con la specifica OCL RUN 
(alcuni passi di lavoro e di programmi di utilità SSP terminano con una specifica 
di controllo di programma di utilità END), La seguente procedura contiene un 
passo di lavoro in quanto viene caricato ed eseguito un solo programma: 


// LOAD PROG1 
// RUN 


Questo successivo esempio ha due passi di favoro in quanto vengono caricati ed 
eseguiti due programmi: 


// LOAD PROG1 
// RUN 
// LOAD PROG2 
// RUN 


CIO' CHE UNA PROCEDURA PUO' CONTENERE 


Le specifiche in una procedura controllano i file, le unità video e le stampatrici 
usate da un programma. Per esempio: 


// LOAD PROG3 
// FILE NAME-CUSTOMER 
// RUN 


Queste specifiche indicano quanto segue: 
LOAD Il programma da eseguire è denominato PROG3. 


FILE Dal programma PROG3 deve essere usato un file su disco 
denominato CUSTOMER. 


RUN Il programma deve essere eseguito. 


Le procedure possono essere costituite dai seguenti tipi di specifica: 


e Specifiche OCL, che vengono usate per caricare ed eseguire i programmi. 
OCL significa linguaggio di controllo operativo. Le specifiche OCL indicano 
anche come il SSP deve eseguire i programmi e come il SSP deve usare le 
unità di immissione e di emissione che il programma può richiedere. Vedere 
Capitolo 5, Specifiche OCL per ulteriori informazioni sulle specifiche OCL 
che vengono usate in questo capitolo, Esempi di specifiche OCL sono LOAD, 
FILE e RUN. 


e Espressioni di controllo procedura, che controllano come la procedura viene 
elaborata sulla base di talune condizioni. Vedere Capitolo 3, Espressioni di 
controllo procedura per ulteriori informazioni sulle espressioni di controllo 
procedura che vengono usate in questo capitolo. 


e Comandi di procedura, che fanno sì che altre procedure vengano eseguite. 
Le procedure fornite dall’IBM come parte del SSP e come parte degli altri 
programmi su licenza, sono descritte nel Capitolo 4, Procedure. Esempi di 
queste procedure sono COPYDATA e BASIC. E’ possibile inoltre usare le 
proprie procedure. 


e Specifiche di controllo programmi di utilità per programmi di utilità SSP che 
trasmettono informazioni ai programmi di utilità SSP. Le specifiche di con- 
trollo programmi di utilità SSP sono indicate nell’Appendice A, Specifiche di 
controllo di utilità per procedure SSP. 


Le procedure non possono contenere comandi di controllo. Vedere Capitolo 6, 
Comandi di controllo per le descrizioni dei comandi di controllo. 


IMMISSIONE DI PROCEDURE NEL SISTEMA 


Si immettono le procedure in una libreria usando il programma di utilità di immissio- 
ne dati origine (SEU) o il programma di utilità di supporto alla programmazione DSU. 
Il SEU è descritto in dettaglio nel manuale Programma di utilità per l'immissione di 
dati origine. La procedura SEU è descritta sia in quel manuale che in questo; vedere 
Procedura SEU. 


Il DSU è descritto in dettaglio nel manuale Programma di utilità di supporto alla pro- 
grammazione. La procedura DSU è descritta sia in quel manuale che in questo; ve- 
dere Procedura DSU. 


E' inoltre possibile usare il programma di utilità $SMAINT per immettere procedu- 
re in una libreria; per informazioni, vedere Programma di utilità $SMAINT, funzio- 
ni addizionali. 


PROCEDURE DI DENOMINAZIONE 


Un nome di procedura può essere composto da qualsiasi combinazione di un 
massimo di 8 caratteri, il primo dei quali deve essere alfabetico (da A a Z, #, $ 
o@ |). 


Occorre fare attenzione quando ad una procedura scritta dall'utente viene attri- 
buito lo stesso nome di una procedura di sistema. Il sistema elaborerà automati- 
camente la procedura che esiste nelia fibreria corrente dell'utente se nella specifi 
ca di procedura non è usato un parametro di libreria. Se nella specifica di proce- 
dura viene usato il parametro di libreria, la procedura viene eseguita dalla libreria 
specificata dal parametro di libreria. Fare riferimento alla Specifica OCL 
INCLUDE per ulteriori informazioni su! parametro di libreria per una specifica 
di procedura. 


Quando viene usata una procedura HELP per specificare parametri per una proce- 
dura di sistema e nella libreria corrente dell'utente esiste una procedura dell’uten- 
te con lo stesso nome, viene visualizzato lo schermo esplicativo delle procedure 
del sistema, ma viene eseguita la procedura dell'utente. Ciò fa sì che la procedura 
dell'utente usi i parametri della procedura di sistema. Se i parametri non corri- 
spondono, la procedura dell'utente non verrà eseguita correttamente. 
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PARAMETRI DI PROCEDURA 


E’ possibile definire parametri per le procedure. | parametri consentono di tra- 
smettere alla procedura informazioni e variabili. | parametri possono avere fino a 
128 caratteri. 


Una procedura può avere un massimo di 64 parametri, | parametri trasmessi alle 
procedure sono detti Parametri posizionali. Ogniqualvolta che in un comando di 
procedura compare un parametro, deve comparire nella stessa posizione rispetto 
agli altri parametri nel comando di procedura. In altre parole, a ciascun parame- 
tro è assegnato un posto o posizione, ad esempio primo parametro, secondo pa- 
rametro, ecc. Se un parametro viene omesso, deve sempre essere usata una virgola 
per indicare la posizione del parametro omesso. 


Per usare i parametri nelle proprie procedure, si ricorre alle espressioni sostituti- 
ve. Per i parametri di procedura possono essere usate le seguenti espressioni sosti- 
tutive. 


Espressione Significato 


?n? L'espressione sostituisce il valore dell’n-esimo parametro 
posizionale nella specifica nella procedura. Per esempio, 
il valore immesso sul comando di procedura nella posizio- 
ne del primo parametro, verrebbe sostituito dall’espres- 
sione ?12. 


?n'‘valore‘? Se l’n-esimo parametro non è immesso (cioè non è speci- 
ficato sul comando di procedura che ha avviato la proce- 
dura), questa espressione definisce il valore dell’n-esimo 
parametro e sostituisce il valore nella specifica nella proce- 
dura. Una volta che un parametro è impostato a ‘valore’, 
rimane a quel valore come se fosse stato immesso. Non è 
una sostituzione temporanea, 


Se viene immesso il parametro n-esimo, questa espressione 
sostituisce il valore del parametro n-esimo nella specifica 
della procedura. 


?nT’valore’? Se non viene immesso l'n-esimo parametro, questa espres- 
sione sostituisce temporaneamente il valore indicato nella 
specifica della procedura. ll valore temporaneo è usato 
soltanto per la sostituzione corrente. 


Se viene immesso il parametro n-esimo, questa espressione 
sostituisce il valore del parametro n-esimo nella specifica 
della procedura. 


?nF‘valore’? Questa espressione modifica il valore del parametro n-esimo 
e sostituisce il nuovo valore nella specifica e nella proce- 
dura. Una volta che un parametro è impostato a ‘valore’ 
rimane a quel valore come se fosse stato immesso. Non è 
una sostituzione temporanea, 


Espressione Significato 


înR? Se non viene immesso l’n-esimo parametro, questa espres- 
sione visualizza un messaggio per immettere il parametro 
richiesto e consente all'operatore di immettere il parame- 
tro. Per i parametri che vengono chiesti dal sistema, il nu- 
mero massimo di caratteri che può essere immesso è 60. 
Questa espressione dà quindi all’n-esimo parametro posi- 
zionale un valore e sostituisce quel valore nella specifica 
nella procedura. 


Se I‘n-esimo parametro ha un valore, non viene visualizza- 
to alcun messaggio e il valore dell’n-esimo parametro posi- 
zionale è sostituito nella specifica e nella procedura. 


?nR'mic'? Se non viene immesso l’n-esimo parametro, questa espres- 
sione visualizza un messaggio che è possibile specificare e 
consente all'operatore di immettere il parametro; Per i pa- 
rametri richiesti dal sistema, il numero massimo di carat- 
teri che può essere immesso è 60. Esso quindi definisce 
l'n-esimo parametro posizionale e sostituisce il valore im- 
messo nella specifica nella procedura. Vedere Procedura 
CREATE a pag. 4-86 per informazioni sul modo in cui 
creare questi messaggi. 


Se viene immesso l’n-esimo parametro non viene visualiz- 
zato alcun messaggio e il valore dell'n-esimo parametro 
posizionale è sostituito nella specifica nella procedura. 


I vafori risolti verranno inseriti nella specifica iniziando dalla posizione del punto 
di domanda (?) più a sinistra. 


Esempio 


E’ stato creato un programma che legge e stampa ie informazioni contenute in un 
file. E" possibile specificare il nome del file come un parametro. 


. Sì crea una procedura denominata PROC1 per eseguire il programma (il pro- 
gramma è denominato PRTFILE). E’ possibile usare programmi di utilità SEU o 
$MAINT per immettere questa procedura nel sistema. il parametro 1 è il nome 
del file su disco da usare. E’ possibile creare la procedura PROC1 come segue: 


// LOAD PRTFILE 
// FILE NAME-INPUT,UNIT-F1,LABEL-?1? 
// RUN 


Si può immettere la procedura PROC1 in un membro di procedura di libreria 
denominato PROC1. Le specifiche nella procedura PROCI1, indicano quanto 
segue: 
LOAD Il programma da eseguire è denominato PRTFILE, 
FILE Deve essere usata dal programma un file su disco (UNIT-F1). tl 
programma fa riferimento al file come INPUT. Il nome del file 


da usare è contenuto nel parametro 1 (indicato da LABEL-?1?). 


RUN Indica che il programma deve iniziare l'esecuzione. 
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Quando si immette il seguente comando per eseguire la procedura PROC1: 
PROC1 FILEA 
le specifiche che realmente vengono eseguite sono: 


// LOAD PRTFILE 
// FILE NAME-INPUT,UNIT-F1,LABEL-FILEA 
// RUN 


Notare che FILEA è stato sostituito in luogo dell'espressione ?1?. 


Valori assunti per difetto dei parametri delle procedure 


E' possibile definire dei valori assunti per difetto per i parametri. Quello assunto 
per difetto è un valore che viene automaticamente sostituito a un parametro 
omesso o indefinito. E' possibile indicare valori assunti per difetto per i parametri 


usando l’espressione sostitutiva ?n'valore”?. 


Esempio 


E' possibile modificare PROC1 in modo che il valore assunto per difetto per il 
nome del file sia EMPLOYES se non viene immesso alcun parametro. E’ possibile 
creare una procedura denominata PROC2 (basata su PROC1) come segue: 


// LOAD PRTFILE 
// FILE NAME-INPUT,UNIT-F1,LABFEL-?1'EMPLOYES!'? 
// RUN 


Si immette la procedura PROC2 in un membro di procedura di libreria denomi- 
nato PROC2 usando il SEU. Le specifiche nella procedura PROC2 indicano 
quanto segue: 


LOAD Come in PROC1. 


FILE Il programma fa riferimento al file su disco come INPUT. Il 
nome del file da usare è contenuto nel parametro 1. Se non 
è stato immesso alcun valore per il primo parametro quando la 
procedura è stata avviata, viene assunto un valore di EMPLO- 
YES per il parametro LABEL; cioè EMPLOYES è il valore 
assunto per difetto per il primo parametro (indicato da 


LABEL—-?1'EMPLOYES??). 
RUN Identico a PROC1, 
Quando si immette il seguente comando per eseguire la procedura PROC2: 
PROC2 
le specifiche che vengono realmente eseguite sono: 
// LOAD PRIFILE 


// FILE NAME-INPUT,UNIT-F1,LABEL-EMPLOYES 
‘// RUN 


VA - 


Notare che poichè non è stato specificato alcun valore per il primo parametro, 
è stato assunto il valore EMPLOYES. 


Ma quando si immette il seguente comando per eseguire la procedura PROC2: 
PROC2 FILEA 
le specifiche che realmente vengono eseguite sono: 


// LOAD PRTIFILE 
// FILE NAME-INPUT, UNIT-F1,LABEL-FILEA 


// RUN 


Notare che poichè è stato specificato un valore per il primo parametro, è stato 
usato quel valore (FILEA). 


Prova dei parametri immessi 


E‘ possibile usare espressioni condizionali IF per controllare i parametri immessi 
per una procedura. Ciò consente di assicurarsi che i parametri siano corretti pri- 
ma di eseguire il programma. 


L'espressione IF assume due forme: 
e Fo IFT prova se le condizioni sono vere 


e FF provase le condizioni sono false 


Esempio 


La seguente procedura richiede che il primo parametro (il nome del file da elabo- 
rare) sia EMPLOY o CUSTOM. Se il prime parametro non è uno di questi valori, 
vengono elaborate soltanto le specifiche PAUSE e CANCEL (che provocano la 
comparsa di un messaggio di errore e la cancellazione della procedura). 


// IF ?1?=EMPLOY GOTO OK 
/) IF 21?=CUSTOM GOTO OK 
// PAUSE 'Parameter 1 must be EMPLOY or CUSTOM' 


// CANCEL 

// TAG OK 

ro, LOAD PRIFILE 

Li FILE NAME-INPUT,UNIT-F1,LABEL-?1? 
194 PRINTER NAME-OUTPUT,DEVICE-?2'P3'? 
71 RUN 


Considerazioni sulla codifica dei parametri 


Lo spazio vuoto (), la virgola (,), l'apice (’), il punto di domanda (?), la barretta 
(/), it segno di uguale (=), il segno più (+), il segno di maggiore (>) e il trattino 
di divisione sillabica (—), hanno significati speciali nelle procedure e nelle specifi- 
che OCL e nelle specifiche di controllo dei programmi di utilità. Questi caratteri 
possono essere usati nei parametri per una procedura ma con cautela. 
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CONTINUAZIONE DELLE RIGHE DI UNA PROCEDURA 


La lunghezza massima di riga di un membro di procedura di libreria o di una 
specifica che è possibile immettere da tastiera, è di 120 caratteri. Se una specifica 
contiene più di 120 caratteri, è possibile usare il simbolo di continuazione per 
proseguirla su una o più righe, Il simbolo di continuazione è un segno più (+) 
nella posizione in cui la riga incompleta termina. È’ possibile usare il segno + per 
continuare le specifiche nelle procedure e per continuare fe righe che si immetto- 
no da tastiera. Il segno + funziona come un carattere di continuazione quando 
non compare alcun altro carattere oltre gli spazi vuoti alla sua destra. 


{Il simbolo di continuazione fa sî che la successiva riga (iniziando con il primo ca- 
rattere diverso dallo spazio vuoto), venga concatenata (o aggiunta) alla riga prece- 
dente. E' possibile continuare quante righe si vogliono, ma il numero totale dei 
caratteri nella specifica concatenata risultante non può superare 512, 


Per esempio, una procedura contiene le seguenti tre righe: 


// IFF ?1?=EMPLOY + 
IFF ?21?=MANAG + 
PROCA TEST,RUN 


La risultante specifica sarebbe: 


// IFF ?1?=EMPLOY IFF ?1?=MANAG PROCA TEST,RUN 


Notare che gli spazi vuoti dopo il segno più e gli spazi prima di ciascuna riga di 
continuazione, sono ignorati. Gli spazi vuoti prima del segno + sono conservati. 
Notare inoltre che non è stato inserito alcun dato di commento dopo i segni +; 
se ci fossero stati dei commenti su queste righe, il segno + sarebbe stato ignorato. 
I dati dei commenti possono essere inseriti sull'ultima riga poichè non c’è conti- 
nuazione. 


Il simbolo di continuazione può essere specificato ovunque nell’ambito della riga, 
ad esempio nell’ambito di un parametro, di un'espressione di sostituzione o in 
qualsiasi altro tipo di dati. Per esempio, una procedura potrebbe contenere le se- 
guenti due righe: 


// IFF ?19?=EMPLOY I+ 
FP_?1?=MANAG PROCA TEST ,RUN 


La risultante specifica sarebbe: 
// IFF ?1?=EMPLOY IFF ?12=MANAG PROCA TEST ,RUN 


Il simbolo di continuazione consente la continuazione in aggiunta alla continua- 
zione ammessa nelle specifiche OCL e nelle espressioni di controllo programmi di 
utilità. 


E’ possibile usare le espressioni di continuazione su tutte le procedure, su tutte le 
specifiche OCL e su tutte le specifiche di controllo dei programmi di utilità. In 
ogni caso non è possibile usare l’espressione di continuazione su una specifica di 
commento (*). Il segno + può essere specificato ovunque nell’ambito della riga. 
Ad esempio nell’ambito di un parametro, nell’ambito di un'espressione di sostitu- 
zione o nel mezzo di una parola. In ogni caso, per rendere le procedure più facili 
da leggere e da aggiornare, continuare soltanto le specifiche al termine delle paro- 
le e delle espressioni. 


Se un record termina con un carattere di translazione a destra immediatamente 
prima dell'espressione di continuazione ed il primo carattere diverso dallo spazio 
in bianco del successivo record, è un carattere di traslazione a sinistra, entrambi i 
caratteri di traslazione verranno eliminati. 


RICHIAMO DI UNA PROCEDURA DA UN'ALTRA PROCEDURA 


Una procedura può richiamarne un’altra. La procedura richiamata da un'altra 
procedura è una procedura nidificata. Ciò è generalmente di aiuto quando la stes- 
sa procedura viene richiamata parecchie volte in un lavoro. La procedura può 
cioè essere immessa e memorizzata soltanto una volta e quindi richiamata tutte le 
volte che è necessario, 


Si supponga per esempio che una procedura denominata PAYROLL contenga (in 
aggiunta ad altre specifiche) un comando di procedura TAXES e che un'altra pro- 
cedura denominata TAXES contenga i comandi di procedura FEDER e STATE. 
Le procedure TAXES, FEDER e STATE, sono tutte richiamate ed eseguite 
quando l'operatore immette il comando di procedura PAYROLL. 


Procedura 
STATE . 
* STATE 


[Lasa 
(9 


Le quattro procedure sono le seguenti: 


Procedura Procedura Procedura 
PAYROLL TAXES FEDER 
* FEDER 


ila 
{1 fis 


















* PAYROLL 
KI ass 
// #0 
TAXES 
(fa 
// +... 
"AREE 










In questo esempio, TAXES, FEDER e STATE sono procedure nidificate. Quando 
termina una procedura nidificata, l'elaborazione ritorna alla successiva istruzione 
neila procedura richiamante. 
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Questo esempio contiene tre livelli di procedura: il primo livello contiene 
PAYROLL, il secondo livello contiene TAXES e il terzo livello contiene FEDER 
e STATE. Un livello può contenere più di un comando di procedura ma non 
sono ammessi più di 255 livelli. Le procedure sono richiamate come segue: 





L'operatore Primo : Secondo Terzo 
immette Livello Livello Livello 
PAYROLL * PAYROLL 
Ì {la 
VERTE 
TAXES * TAXES 
(richiama) Uro 
Pa dere 


FEDER — —____- * 0FEDER 
(richiama) Mi 


flda 
J 





/ n (ritorna) 


// CECI 
STATE ———_—____-+e-* STATE 
(richiama) Ida 


SA iosa 
"7 SIA (ritorna) 
fio 
n A (ritorna) 
Li sx 


ATTRIBUTI DELLE PROCEDURE 


A una procedura possono essere assegnati i seguenti attributi, Essi sono assegnati 
quando la procedura viene creata o modificata dal SEU o quando la procedura è 
creata dal programma di utilità $MAINT. 


e Se la procedura è una procedura per terminali richiedenti multipli (MRT). 
Per informazioni sui programmi e procedure MRT, vedere il manuale Con- 
cepts and Programmer's Guide. Normalmente le procedure sono procedure 
per terminale richiedente singolo. 


e Se le specifiche OCL devono essere registrate nel file storico, cronologico. E’ 
possibile evitare che le specifiche OCL vengano registrate sui file storico, cro- 
nologico quando la procedura viene eseguita; vedere la Procedura LOG. Il co- 
mando di procedura che avvia una procedura è sempre registrato sul file sto- 
rico, cronologico. Normalmente il comando di procedura e le specifiche OCL 
per le procedure sono tutti registrati sul file storico, cronologico. Ciò avviene 
per facilitare le operazioni di ricerca e correzione degli errori. 


e Se passare parametri alla procedura o passare dati al programma. Se l’attribu- 
to dati al programma è impostato, i dati sul comando di procedura sono 
passati al primo programma eseguito dalla procedura. | dati vengono passati 
alla prima unità video che fa richiesta di lettura o di immissione. | dati ini- 
ziano con il primo carattere diverso dallo spazio vuoto che segue il nome del- 
la procedura o della libreria e terminano con l’ultimo carattere diverso dallo 
spazio vuoto nella specifica. Per esempio: 


PAYROLL DATAOIl 
La procedura PAYROLL potrebbe avere due campi di dati. 
1. Le posizioni da 1a 4 (che contengono (DATA) 
2. Le posizioni 5 e 6 {che contengono 01) 
Ogni procedura MRT ha questo attributo quantunque l'attributo possa non 
essere stato selezionato quando la procedura è stata creata. Normalmente le 


procedure per terminale richiedente singolo, trasmettono i parametri alla pro- 
cedura, 
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PROCEDURE ESEMPLIFICATIVE 


Esempio 1: Procedura SAMPLE 


Questo esempio mostra una procedura denominata SAMPLE. Si tratta di una 
procedura alquanto semplice in quanto ha soltanto due parametri, il file da usare 
e la data di creazione del file. Questa procedura non è fornita come parte di 
qualsiasi programma su licenza e deve pertanto essere immessa dall'utente che la 
vuole eseguire. La procedura esegue il programma di utilità $COPY ed ha un fun- 
zionamento simile alla procedura LISTDATA. Per ulteriori informazioni sulle spe- 
cifiche in questa procedura, vedere Specifiche di procedura LISTDATA: pro- 
gramma di utilità $COPY , 


nome file, |mmggaa 


ggmmaa 
aammgg 





nome file specifica il nome di un file da listare. Questo parametro deve essere 
specificato; se viene omesso, è richiesto dalla procedura. 


mmggaa, ggmmaa o aammgg specifica la data di creazione del file. 
Le specifiche nella procedura SAMPLE sono le seguenti: 


* SAMPLE Procedura 
Parameter l: Nome file (indispensabile, richiesto se omesso) 
D+ Parameter 2: Data di creazione del file (facoltativo) 
// * *SAMPLE PROCEDURE RUNNING' 
xj_// LOAD $COPY 
n°. / FILE NAME-COPYIN,LABEL-?1R?, 
— //  IFF 22?= DATE-?22, 
6, wr 
G--// run 
E // COPYFILE OUTPUT-CHAR 
]-_-// END 


sl 


Pani 


Descrizione delle righe nella procedura SAMPLE 


Qui di seguito sono descritte le righe contenute nella procedura SAMPLE. Per ul- 
teriori informazioni sulle specifiche OCL in questa procedura, vedere Capitolo 5, 
Specifiche OCL. Per ulteriori informazioni sulla specifica di controllo di pro- 
gramma di utilità COPYFILE in questa procedura, vedere Specifiche procedura 
LISTDATA: Programma di utilità $COPY . 


OG EN 25 
® 


S 


Descrizione 


Visualizza un messaggio per indicare che la procedura è in ese- 
cuzione. 


Carica il programma di utilità $COPY nella memoria principale. 


Definisce il nome del file da listare, Se il primo parametro non 
è stato immesso, viene richiesto usando l’espressione ?1R?. 


Se è stata specificata una data, viene incluso il parametro DATE. 


Specifica che il file è un file su disco, Notare che poichè il para- 
metro UNIT non termina con una virgola, è l’ultimo parametro 
della specifica FILE. Ciò fa sì che il parametro DATE sia facol- 
tativo. E cioè se non è stato specificato alcun parametro di da- 
ta, il parametro DATE non viene generato. 


Inizia l'esecuzione del programma $COPY, che legge quindi le 
specifiche di controllo dei programmi di utilità COPYFILE e 
END. 


Fa sì che vengano listati i caratteri stampabili nel file. 


Indica la fine delle specifiche di controllo di programma di uti- 
lità al programma $COPY. 
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Esempio 2: Procedura LISTKEY 


Questo esempio mostra una procedura denominata LISTKEYS. Si tratta di una 
procedura alquanto più difficile in quanto contiene sei parametri, due dei quali 
hanno valori assunti per difetto. Questa procedura non è fornita come parte di 
qualsiasi programma su licenza e deve pertanto essere immessa dall’utente che fa 
vuole eseguire. La procedura esegue il programma di utilità $COPY e ha un fun- 
zionamento simile alla procedura LISTDATA. Per ulteriori informazioni sulle 
specifiche in questa procedura, vedere Specifiche di procedura LISTDATA: Pro- 
gramma di utilità $COPY . 


ggumaa PKY HEX 
aammgg PARTHEX 


CRT 


LISTKEYS nome file, |mmggaa]| , Ei 5 | prina chiave | 5 [| itima chiave | , | CHAR 





nome file specifica il nome di un file a indice da listare. Questo parametro deve 
essere specificato. Se viene omesso, è richiesto dalla procedura. 


mmggaa, ggmmaa o aammgg specifica la data di creazione del file. 


KEY specifica che il file a indice ha delle chiavi normali (non in formato decima- 
le compatto). Se non è specificato alcun parametro, viene assunto KEY. 


PKY specifica che il file a indice ha delle chiavi in formato decimale compatto. 
Pf 
prima chiave specifica la prima chiave del file‘che deve essere listata. Se non è 
specificato alcun parametro, il file viene listato iniziando con la prima chiave 
nel file. 


ultima chiave specifica l’ultima chiave nel file da listare. Se non viene specificato 
alcun parametro, il file è listato terminando con l’ultima chiave del file. L’ul- 
tima chiave può essere specificata soltanto se è specificata la prima. 


CHAR specifica che i caratteri stampabili nel file devono essere listati. Qualsiasi 
carattere non stampabile è listato come spazio vuoto. Se non è specificato 
alcun parametro, viene assunto CHAR. 


HEX specifica che devono essere listati sia i caratteri stampabili che le relative 
rappresentazioni esadecimali. Qualsiasi carattere non stampabile viene listato 
come spazio vuoto ma ne devono essere listate le rappresentazioni esade- 
cimali. 

PARTHEX specifica che i caratteri stampabili nel file devono essere listati. Inol- 
tre, se alcuni caratteri non sono stampabili, devono essere listate le relative 


rappresentazioni esadecimali. 


CRT specifica che i record devono essere visualizzati. 


‘> Pagina- lasciata intenzionalmente - bianca 











53 


Le specifiche nella procedura LISTKEYS sono le seguenti: 


Hd . LISTKEYS Procedure 
BT // MEMBER USERl-MESSAGES,LIBRARY-MYLIB 
Ki // IF JOBQ-NO IF EVOKED-NO * 0001 
a // IF ?1?= EVALUATE ?iR'0002'? 
— — // 1F ?1?= RESET LISTKEYS ,222,232,212,252,26? 
E —— // EVALUATE ?3'KEY'? 26'CHAR'? 
A // IFF ?3?=KEY IFF 23?=PKY ERR 0003,3 
// IFF ?6?=CHAR IFF 262=HEX + 
IFF ?62=PARTEX IFF ?6?=CRT ERR 000,3 
G--// IF ?4?=IFF ?52= ERR 0005,3 
O // LOAD $COPY 
__ [| FILE NAME-COPYIN,LABEL-?1?, 
© _//  IFF ?2?= DATE-?22, 
277) UNIT-F1 
// RUN 
// COPYFILE OUTPUT-?6? ,REORG-YES 
/ IFF ?242= IF 252= SELECT 23?,FROM-?k7? 
IFF ?h2= IFF 252= SELECT 73?,FROM-?k?,T0-25? 
END 
/ RETURN 
Parametri: 
1 Nome file (indispensabile, richiesto se omesso) 
2 Data di creazione del file (facoltativa) 


nq 


MRMKIÎt 


SNANEA 
ESA 
MOON 0 RR 


AS 
È 


compatto (valore assunto per difetto: KEY) 

Ù Prima chiave da listare (valore assunto per difetto: 
prima chiave nel file) 

5 Ultima chiave da listare (valore assunto per difetto: 
ultima chiave nel file) 


listato (valore assunto per diffetto: CHAR) 


La procedura LISTKEYS usa cinque messaggi da un membro di messaggi deno- 
minato MESSAGES che si trova nella libreria denominata MYLIB. | messaggi in 
MESSAGES, sono i seguenti: 


MESSAGES, 1 
0001 La procedura LISTKEYS è in esecuzione 

0002 Immettere il nome del file a indice da listare: 
0003 Il terzo parametro deve essere KEY, PKY o vuoto 


0004 Il sesto parametro deve essere CHAR, HEX, PARTHEX, CRT o vuoto 


0005 E' ammessa l'ultima chiave solo se è stata immessa la prima. 


Per ulteriori informazioni sui membri di messaggio, vedere la Procedura CREATE. 


Descrizione delle righe nella procedura LISTKEYS 


Qui di seguito sono descritte le righe nella procedura LISTKEYS. Per ulteriori in- 
formazioni sulle specifiche OCL di questa procedura, vedere il Capitolo 5, Spec: 
fiche OCL. Per ulteriori informazioni sulle specifiche di controllo del programma 
di utilità COPYFILE e SELECT in questa procedura, vedere Specifiche di proce- 
dura LISTDATA: Programma di utilità $COPY . 


Riga Descrizione 


1] Indica il membro di messaggi dell'utente di primo livello (deno- 
minato MESAGES). 


Visualizza un messaggio se la procedura è immessa da tastiera. Il 
messaggio ha il numero 0001. 


3. KEY o PKY. Indica chiavi normali o in formato decimale 


6 CHAR, HEX, PARTHEX o CRT: indica come il file deve essere 


NESaO 


— — — —_ 
e) Ga rS 3 | 


_—_ n 
(°°) N 


Se il nome del file viene omesso, un messaggio visualizzato lo 
chiede. Il messaggio ha il numero 0002. 


Se l'operatore non ha immesso un nome, la procedura viene 
riavviata. Sono inclusi tutti i parametri che l'operatore ha im- 
messo, 

Se non è specificato il terzo parametro, viene assunto KEY; se 
non è specificato il sesto parametro, viene assunto CHAR. 


Se il terzo parametro non è KEY o PKY, viene visualizzato un 
messaggio di errore. li messaggio ha il numero 0003 e un'opzio- 
ne di errore 3. Occorre prendere l'opzione 3 e cancellare la pro- 
cedura. 


Se il sesto carattere non è CHAR, HEX, PARTHEX o CRT, 
viene visualizzato un messaggio di errore. Notare come è stato 
usato il segno + per continuare questa specifica su due righe. 
{1 messaggio ha il numero 0004 e un'opzione di errore 3. Oc- 
corre prendere l'opzione 3 e cancellare la procedura. 


Se non è specificato un quarto parametro ma ne è specificato 
un quinto, viene visualizzato un messaggio di errore. Il messag- 
gio ha il numero 0005 e un'opzione di errore di 3. Occorre 
prendere l'opzione 3 e cancellare la procedura. 


Carica il programma di utilità $COPY nella memoria centrale. 
Definisce il nome del file da listare. 
Se è stata specificata una data, viene incluso il parametro DATE. 


Specifica che il file è un file su disco. Notare che poichè il para- 
metro UNIT non termina con una virgola, è l’ultimo parametro 
delia specifica FILE. Ciò fa si che il parametro DATE possa 
essere facoltativo; cioè se non è stato specificato alcun parame- 
tro di data, non viene generato il parametro DATE. 


Inizia l'esecuzione del programma $COPY, che quindi legge le 
specifiche di controllo programma di utilità COPYFILE, SE- 
LECT e END. 


Specifica come il file deve essere listato (OUTPUT-?6?). 
REORG-YES specifica che i record devono essere listati sequen- 
zialmente per chiave indice, 


Se viene immesso il parametro 4 e non viene immesso il para- 
metro 5, il file viene listato iniziando con la chiave specificata. 
Se non sono immessi i parametri 4 e 5, l’intero file viene listato. 


Se sono immessi entrambi i parametri 4 e 5, il file viene listato 
iniziando con la chiave specificata e terminando con la chiave 
specificata. 


Indica al programma $COPY la fine delle specifiche di controllo 
del programma di utilità. 


Termina la procedura. Le specifiche di commento che seguono 
RETURN, non sono lette dal sistema. 
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Esempio 3: Procedura SCRNPRT 


Questo esempio mostra una procedura denominata SCRNPRT, che richiama un 
programma che legge un file e stampa informazioni da quel file. La procedura ha 
cinque parametri e mostra uno scherîno di richiesta se l'operatore non immette 
alcun parametro. La procedura controlla inoltre ciascun parametro per assicurarsi 
che il suo valore sia corretto. Se viene riscontrato un parametro errato, viene ri- 
presentato lo schermo di richiesta con un messaggio indicante il parametro errato; 
‘ inoltre, il cursore è posizionato su quel parametro e il parametro viene evidenzia- 
to in alta intensità. 


Questa procedura non è fornita come parte di qualsiasi programma su licenza e 
deve pertanto essere immessa dall'utente che la vuole eseguire. 


SCRNPRT nome file,|id stampatrice|, |copie|,|10],|6 


Pl L 15| {8 
P2 





Se non viene immesso il primo parametro, compare lo schermo di richiesta. 
nome file specifica il nome di un file da listare. 


id stampatrice specifica l'ID della stampatrice da usare, E’ possibile specificare P1 
o P2; P1 è il valore assunto per difetto. 


copie specifica il numero di copie da stampare. juò essere immesso qualsiasi nu- 
mero da 1 a 5. 1 è il valore assunto per difetto. 


10 0 15 specifica il valore dei caratteri per pollice da usare. Il valore assunto per 
difetto è 10. 


6 o 8 specifica il valore delle righe per pollice da usare. 6 è il valore assunto per 
difetto. ; 


La Figura 1 mostra una lista della procedura SCRNPRT. La Figura 2 mostra uno 


schermo campione del tipo di quelli presentati nella procedura. La Figura 3 mo- 
stra le specifiche S e D usate per creare lo schermo. 
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Zen 


Vans 


SCRNFRT 


FParametor li 
Farameter 2% 
Farameter 3° 
Parameter di 
Farameter S! 


+ 


Farameter di 
Farameters 3 


Paramoter 31 
Pàrameter 32 
Farameter 33 
Farameter 34 


Farameter 35 


ARCIERI ONORE NON ICON NC 


#/ EVALLATE 72 
* 


/5 IF 1,7? 
* 
/f TAD FROMET 
* 


GSsSaSnN 


Frints the Frint key display images contained in a disk file 


Hame of file containing display images 


Frinter ID to use (PI or P2) lefaulti FI 
Number of copies to print 1-5) Defaultt i 
CPI value (19 or 15) Default! 10 
LFI value {6 ar 3) Default: é 


Fiessage fer crompt dispiay. 
1 through 35 are used for error indicators 


* File name error 

i Printer ID error 

* RKusber of copies error 
s CFI error 

i LPI error 


Set parameter defaults 


IP1t9 93*1!9 94210*9 251617 


// IFF ?1?= GOTO CHKFILE 
5 
#£ IF ?9L'1,8'I=SCRNSFOL EVALUATE F1=5L'10,3*2 lefault for parm i 


=SCRNFRT EVALUATE F1=2'10,8*7 Default for parm 1 


// PROMPT MEMBER-SCAN,FORMAT-SCRNFRT, LENGTH-!3,2,1,2,1,75* 


// IF ?CD9=200 

* 

* fesst error 

// EVALUATE F3 

* 

#7 IFF_9192= 60 

fi EVALUATE Fé 

57 GST0 FROMET 
* 

18] Zi TAG CHKFILE 
* 


// IF_DAT&F1-? 


So 


// EVALUATE Fé6='File 71? does not exist, enter a different name.! P31='X* 


// GOTO PROMET 


E 7 tac FILEOK 


75 LOCAL OFFSE 


I) // FF 223=p1 


/f GOTO FSCHK 
45 TAG F2ERR 

/i EUALUATE F& 
/î GOTI FROMPT 


#7 TAG FICHK 


fi IFF_239331 I 
// GOTO PACHK 
// TÀG FIERR 
/i EVALLATE Fé 
// GOTÒ PROMPT 
// Tà6 FACHK 
/2°IFF_249=10 
Î# SITO FSCHK 
// TèG FAERR 
#7 EVALUATE Fà 


7 RETURN Cad? - End Frocedure 


indicators 
i= F32= P33=> PI4= FJ53 


TO CHKFILE 
=*You aust enter a file name,’ FIi=?X! 


1? GOTO FILEDK 


T-10, BLANK-8, DATA-!919? 
IFF_729=P2 IFF_222=PX GOTO FOERR 


='frinter IÎl must be FL or F2; re-enter value.' P32='x* 


FF_?39=2 IFF_939=3 IFF_939=4 IFF_933=5 GOTO FJERR 


PI 


='Nunber of copies must be 1 through S,' PFI3='X! 


IFF_ 749315 GOTO F4ERR 


='Character per inch value mast be 10 or 154° Fasatx? 


Figura 1 (Parte 1 di 2). Lista della procedura SCRNPRT 
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/5 GOTO PROMPT 
M 
#5 TAG PSCHK 
#/ IFF_#59=6  IFF_259=2 GOT 
#i GOTO RUN 
45 TSG FSERR 
fi EVALUATE Fé='Line per inch value must be 6 or 3+° PISSW 
FF GOTO PROMPT 


Lo) 
/# TAG RUN 


FOERR 


LI 


* 
// LOCAL BLANK-#4LL, DATA-*SCRNFRT* Frocedure nane 
// LOCAL OFFSET-10,1ATA=!919? File name 
£ IDCAL DFFSET-20,DATA-!209? Mintar ID 
// LOCAL OFFSET-30, DATA-?239? Nuaber of copies 
// LOCAL OFFSET-40,DATA—-!249) CPI value 
// LOCAL OFFSET-50,[DATA=*759? LPI value 
## IF 959?9=2 LOCAL. OFFSET-60, DATA-!38' Lines per page setting if LFI=8 
If IF 959=6 LOCAL OFFSET-60,DATA-*66* Lines per page setting if LPI=6 


{E // 1NFONSG NO 
*% 
BASICR SCRNFRT, TEMLIB,32,,SCRNFRT® 
* 
// 1F_BATAF1-SCRN,?W59 DELETE SCRN,2W46?,F1 
/7 TNFONSG YES 
ff % *Wisplays printed. 


Figura 1 (Parte 2 di 2). Lista della procedura SCRNPRT 


Poma 


Descrizione della procedura SCRNPRT 


Qui di seguito sono descritte le righe richiamate nella procedura SCRNPRT nella 
Figura 1. Per ulteriori informazioni sulle specifiche OCL di questa procedura, ve- 
dere il Capitolo 5. Specifiche OCL. 


Gruppo Descrizione 
di righe 
Informazione di commento. Descrive la procedura in generale e 


ne descrive ciascun parametro. 
Imposta i valori assunti per difetto per i parametri da 2 a 5. 


Se viene immesso il parametro 1 (il nome del file), la specifica 
GOTO evita la presentazione iniziale dello schermo delle richieste. 


DI Se l'operatore non ha immesso un nome, viene assunto il nome 
del file memorizzato nell’area dati locale. Il nome è memorizza. 
to nelle posizioni da 10 a 17 dalla procedura SCRNPRT (o da 
un’altra procedura detta SCRNSPOL). 


El 


Mostra lo schermo delle richieste. Il membro oggetto del trac- 
ciato video è denominato SCRN. Il tracciato è denominato 
SCRNPRT (per farlo corrispondere al nome della procedura). 
Se l'operatore preme il tasto di comando 7, la procedura ter- 
mina. 


G Annulla i parametri usati per gli indicatori di errore di tracciato 
video, 


Se sullo schermo della richiesta non è immesso il nome del file, 
il parametro 6 viene impostato ad un messaggio e viene ripre- 
sentato lo schermo delle richieste. AI parametro 31 viene attri- 
buito un valore che imposta l'indicatore 31 e che fa sì che il 
cursore venga posizionato al campo del nome file. Visualizza 
inoltre il campo in negativo. i 


S 


18] Se il nome file immesso non esiste, il parametro 6 viene impo- 
stato ad un messaggio e viene ripresentato lo schermo delle ri- 
chieste. AI parametro 31 viene attribuito un valore che imposta 
l'indicatore 31 e fa sì che il cursore venga posizionato sul cam- 
po del nome del file. Visualizza inoltre il campo con inversione 
di condo. 


Se il file esiste, il nome è memorizzato nell’area locale di dati. 


i) Se l'ID della stampatrice immesso non è P1 o P2, il parametro 
6 viene impostato ad un messaggio e viene ripresentato lo 
schermo delle richieste. AI parametro 32 viene attribuito un va- 
lore che imposta l'indicatore 32 e che fa sì che il cursore venga 
posizionato sul campo ID della stampatrice. Inoltre visualizza 
il campo con inversione di fondo, 


11] Se il numero delle copie immesse non è compreso fra 1 e 5 il 
parametro 6 viene impostato ad un messaggio e viene ripresenta- 
to lo schermo delle richieste. AI parametro 33 viene attribuito 
un valore che imposta l'indicatore 33 e che fa sì che il cursore 
venga posizionato sul campo del numero delle copie, Inotre vi- 
sualizza il campo con inversione di fondo. 
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Se il valore caratteri per pollici immesso non è 10 o 15, il para- 
metro 6 viene impostato ad un messaggio e viene ripresentato lo 
schermo delle richieste. A! parametro 34 viene attribuito un va- 
lore che imposta l'indicatore 34 e che fa sì che il cursore venga 
posizionato sul campo caratteri per pollice. Inoltre visualizza il 
campo con inversione di fondo. ° 


Se il valore righe per pollice immesso non è 6 o 8, il parametro 
6 viene impostato ad un messaggio e viene ripresentato lo 
schermo delle richieste. AI parametro 35 viene attribuito un va- 
lore che imposta l'indicatore 35 e che fa sì che il cursore venga 
posizionato sul campo righe per pollice. Inoltre visualizza il 
campo con inversione di fondo, 


Memorizza i valori dei parametri nell’area locale dei dati. II pro- 
gramma legge questi valori per stampare correttamente le infor- 
mazioni. Per assicurarsi che le righe della carta si allineino, il 
valore righe per pagina è impostato sulla base del valore righe 
per pollice. 


Fa sì che i messaggi informativi non vengano visualizzati. 


-— MU 
A E 


Esegue un programma BASIC che legge il file e stampa le in- 
formazioni memorizzate nel file. 


pus 
e | 


Cancella un file di lavoro temporaneo creato dal programma 
BASIC e visualizza un messaggio indicante che la procedura è 
terminata. 


SCRNPRT PROGRAMMA 


Questo programma stampa le informazioni contenute in un file su disco 


Nome del file che contiene le informazioni 
Id stampatrice da usare 


Numero di copie 


Caratteri per pollice (15 validi solo per Pl) 


Righe per pollice (8 valide solo per Pl) 


CMD7-Fine programma 





Figura 2. Esempio di schermo di schermo di richiesta SCRNPRT. 


dalla procedura. Per ulteriori informazioni sui tracciati video, vedere il manuale 


Qui di seguito sono indicate le specifiche S e D per il tracciato video presentato 
Guida alia Definizione dei Tracciati Video. 
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Figura 3. Specifiche S e D per il tracciato video SCRNPRT 
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Le specifiche H sono facoltative. Se si decide di utilizzarle, bisogna inserirle fra le specifiche S e le specifiche D di un 


tracciato video. 




















12345 









































61 


62 


SUGGERIMENTI PER MIGLIORARE L'ESECUZIONE DELLE PROCE- 
DURE E TECNICHE DI CODIFICA 


Dopo aver imparato a creare procedure, è possibile usare questa sezione per mi- 
gliorare le prestazioni delle procedure stesse. 


è Usare le specifiche GOTO e TAG anziché parecchie espressioni ridondanti |F. 
Usare soltanto un'espressione IF e un'espressione GOTO per ridurre il tempo 
necessario per valutare parecchie espressioni IF. Le specifiche saltate dalle 
espressioni GOTO e TAG, non sono elaborate. Per esempio, anziché procede- 
re come segue: 


// IF 91?/Y LOAD $MAINT 
// IF ?12/Y RUN 


// IF ?12/Y COPY FROM-#LIBRARY,NAME-TEST,LIBRARY-P,TO-PRINT 


// IF ?12/Y END 


Adottare questa soluzione, che evita di duplicare le prove per il parametro 1 
usando le specifiche GOTO e TAG: 


// IFF 219/Y GOTO A 
// LOAD $MAINT 


// RUN 
// COPY FROM-#LIBRARY,NAME-TEST,LIBRARY-P,TO-PRINT 
// END 
// TAG A 


e Usare le specifiche ELSE se c'è più di un'espressione IF e soltanto una delle 
espressioni può essere vera. Tutte le specifiche ELSE sono saltate dopo una 
espressione IF vera. Per esempio, anzichè procedere come segue per elaborare 
tutte e tre le specifiche quantunque una sola delle specifiche sia vera: 


// IF ?22/T SWITCH 1XXXXXXX 
// IF ?22/I SWITCH X1XXXXXX 
// IF ?222/S SWITCH XX1XXXXX 


Adottare questa soluzione che interrompe l'elaborazione dopo la prima con- 


dizione vera: 
// IF ?22/T SWITCH 1XXXXXXX 
/1 ELSE IF ?27/J SWITCH X1XXXXXX 
// ELSE IF ?27?/S SWITCH XX1XXKXX 


Len 


Combinare ie espressioni IF dove è possibile. il resto di un'istruzione non 
viene elaborato dopo una condizione falsa. Per esempio, piuttosto che proce- 
dere come segue (sprecando spazio nella libreria): 


// IF 222/T GOTO NEXT 
// IF 222/J GOTO NEXT 
// IF 22/5 GOTO NEXT 
// GOTO ERROR 

// TAG NEXT 


// RETURN 

// TAG ERROR 

// PAUSE 'ERROR IN PARAMETER 2' 
// CANCEL 


Adottare questa soluzione, che controlla il valore del parametro 2 Se non è 
uguale a T, J o S, viene elaborato ERROR: 


// IFF ?22/T IFF ?222/J IFF ?2?/S GOTO ERROR 


// RETURN 

// TAG ERROR 

// PAUSE 'ERROR IN PARAMETER 2' 
// CANCEL 


Evitare di usare la specifica di messaggio informativo (//*) per visualizzare 
messaggi di richiesta (ad esempio: ENTER MEMBER NAME o ENTER LI. 
BRARY NAME). Usare invece la specifica PROMPT e un tracciato video. | 
vantaggi sono: 


— E’ possibile visualizzare più informazioni. 

— Sono richieste meno operazioni sul disco. 

— Per le unità video a distanza, vengono effettuate meno trasmissioni di 
dati. La specifica //* deve salvare i contenuti dello schermo corrente, 
mostrare il messaggio e ripresentare lo schermo al termine della procedu- 
ra. La specifica PROMPT mostra soltanto il tracciato video senza dover 
salvare i contenuti dello schermo corrente. 


Vedere la Specifica OCL PROMPT per ulteriori informazioni. 


Dopo aver provato le procedure, interrompere la registrazione delle specifiche 
OCL sul file storico, cronologico. E’ necessario registrare le specifiche OCL 
soltanto quando si sta creando e provando la procedura. E’ possibile inter- 
rompere la registrazione in uno dei due modi: 


— HI SEU ha un'azione di fine lavoro che consente di specificare se le speci- 
fiche devono essere registrate. Vedere il manuale Programma di utilità 
per l'immissione dei dati origine (SEU). 

— Il comando LOG o ia specifica OCL LOG, possono indicare se le speci- 
fiche devono essere registrate. Vedere la Procedura LOG o la Specifica 
OCL LOG. 


Evitare l’uso di commenti nella procedura. Leggere i commenti fa aumentare 
il tempo di sistema. 
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Usare le proprie librerie per ie proprie applicazioni, cioè eseguire procedure 
e programmi da una libreria diversa dalla libreria di sistema (#LIBRARY). 
La libreria di sistema ha un grandissimo indirizzario e pertanto occorre più 
tempo per cercare un membro di libreria nella libreria di sistema che non lo 
stesso membro in una delle proprie librerie. 


Inoltre, il SSP cerca sempre per prima cosa nella libreria corrente e se non 


trova il membro, cerca nella libreria di sistema. Vedere la Procedura SLIB e 
la Specifica OCL LIBRARY per ulteriori informazioni sull’impostazione del- 
la libreria corrente. 


Usare le espressioni sostitutive per concatenare i valori. Per esempio: 


// IFF ?12/0 IFF ?12/1 GOTO ERROR 
// SWITCH XXX?19XX?12X ° 


Se il primo parametro è 1, la specifica SWITCH, sarà: 
/} SWITCH XXX1XX1X 

Se il primo parametro è 0, la specifica SWITCH, sarà: 
// SWITCH XXXOXXOX 


Concatenare i valori per creare nomi esclusivi. Per esempio, l’espressione 
?WS? che sostituisce l'ID dell'unità video corrente, può essere usata per 
creare un nome file unico per ciascuna unità video: 


// FILE NAME-OUTPUT,LABEL-FILEA?WS? 


Ciò consente a più di un operatore di usare la procedura contenente questa 
specifica poichè ciascuna unità video avrebbe un proprio file di lavoro esciu- 
sivo. Il programma fa riferimento al file di emissione come OUTPUT e se un 
operatore dell'unità video W1 eseguisse la procedura, il nome effettivo del 
file, sarebbe FILEAWI1, 


e Usare espressioni condizionali IF per evitare che l'operatore di sistema debba 
rispondere ad un messaggio informativo quando viene inviata una procedura 
alla coda di lavori o quando la procedura è avviata dalla specifica OCL 
EVOKE o da un‘operazione di richiamo SSP-ICF. Per esempio: 


// IF JOBQ-NO IF EVOKED-NO * ‘Procedure running! 


Questo esempio visualizza il messaggio soltanto quando la procedura viene 
eseguita dall'unità video; cioè non dalla coda di lavori e non quando viene ri- 
chiamata dalla specifica OCL EVOKE. 


e Modificare il valore di un parametro che consente all'operatore dì usare mi- 
nori operazioni sui tasti. Per esempio: 


// * ‘ENTER 1 TO PROCESS MONTHLY; 2 TO PROCESS WEEKLY! 


/} IF ?91R?=1 EVALUATE P1='MONTHLY! 
// ELSE IF ?1?2=2 EVALUATE Pl='WEEKLY' 
/} ELSE CANCEL 


INVENTRY ?1? 


Se l'operatore immette 1, viene eseguita la procedura INVENTRY MONTHLY; 
se l'operatore immette 2, viene eseguita la procedura INVENTRY WEEKLY. 
Se non viene immesso né 1 né 2, la procedura viene cancellata. 


RICERCA E CORREZIONE DEGLI ERRORI NELLE PROCEDURE 


E’ possibile usare le specifiche OCL LOG e DEBUG e la procedura HISTORY 
per controllare e correggere gli errori delle procedure. Vedere la Specifica OCL 
DEBUG, \a Specifica OCL LOG e la Procedura HISTORY per ulteriori informa- 
zioni. 
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Capitolo 3. Espressioni di controllo procedura 


Questo capitolo descrive le espressioni e le specifiche che è possibile usare per 
controllare l'elaborazione dèlle procedure. 


Queste espressioni e specifiche possono essere disposte ovunque tra le specifiche 
in una procedura; e cioè ovunque tra le specifiche OCL e le specifiche di control 
lo dei programmi di utilità. Le espressioni di controllo procedura comprendono 
quanto segue: 

e Specifiche di commento 

e Espressioni di sostituzione 

e Espressioni condizionali IF 

e Espressioni ELSE 

e Specifica messaggio informativo (//*) 

e Specifica messaggio console di sistema (//**) 

e Specifica CANCEL 

e Specifica EVALUATE 

e Specifiche GOTO e TAG 

e Specifica PAUSE 

e Specifica RESET 


e Specifica RETURN 
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COSE CHE E’ POSSIBILE FARE USANDO LE ESPRESSIONI Di CON- 
TROLLO PROCEDURA 


Questa sezione elenca parecchie delle funzioni che è possibile svolgere usando le 
espressioni di controllo procedura, Le funzioni sono elencate nei seguenti gruppi: 


Sostituzione di valori e di informazioni 

Visualizzazione di messaggi o di tracciati video 
Informazioni su file di dati 

Informazioni su librerie 

Informazioni su minidischi 

Informazioni su nastri 

Confronto e valutazione dei valori e salto nelle procedure 
Prova della procedura o dell'ambiente di lavoro 


Fine delle procedure 


Sostituzione di valori e di informazioni 


Tasti di comando 


Per controllare se un tasto o funzione di comando è stato premuto, vedere 
l’Espressione ?2CD? (Codice di ritorno). 


Data e ora 


Per sostituire la data corrente, vedere l’Espressione ?DATE? (Data program- 
ma). 


Per cambiare la data vedere Specifica OCL DATE. 


Per sostituire l'ora corrente, vedere l’Espressione ?2TIME? (Ora sistema). 


Nomi di libreria 


Per sostituire il nome della libreria corrente, vedere l’Espressione ?2CL/B? (Li- 
breria corrente). 


Per sostituire il nome della libreria di sessione, vedere l'Espressione ?SL/B? 
(Libreria di sessione). 


Per modificare la libreria corrente o di sessione, vedere la Procedura SLIB 
o la Specifica OCL LIBRARY. 


Area dati locale i dat 
Per sostituire i dati dalla Area dati locale, vedere l'Espressione ?L ‘posizione, 


lunghezza‘? (Area dati locale). 


Per inserire informazioni nell’area dati locale, vedere Specifica OCL LOCAL. 


Testo di messaggio EEE 
Per sostituire i dati da un membro di messaggi, vedere l’Espressione ?Mmic? 


o ?M’mic, posizione lunghezza’? (Membro di messaggi). 


Per specificare quale membro di messaggi deve essere usato, vedere la Speci- 
fica OCL MEMBER. 


Parametri 
Per sostituire i valori di un parametro che è stato immesso in una specifica 


di procedura, vedere quanto segue: 


e  L'Espressione ?2n? {Parametro} 

e  L’'Espressione ?n°valore’? (Parametro assunto per difetto) 

e  L'Espressione ?nTvalore’? (Parametro valore temporaneo) 
e L'Espressione ?2nF'valore’? (Parametro valore forzato} 

e  L'Espressione ?R? (Parametro indispensabile) 

e L’Espressione ?nR? {Parametro mancante) 

e L'Espressione ?nR'mic'? (Messaggio parametro mancante) 
e La Specifica EVALUATE . 


Per sostituire la lunghezza di un parametro, vedere l’Espressione ?Cn? (Lun- 
ghezza parametro). 


$Stampatrici 
Per sostituire l'ID della stampatrice di sessione, vedere l’Espressione ?PRIN- 
TER? (Stampatrice di sessione) . 


Per sostituire l'unità di lista di sistema (un [D di stampatrice o se l’emissio- 
ne deve essere stampata o visualizzata), vedere l'Espressione ?SYSLIST? 
{Unità lista di sistema) . 


Per specificare una stampatrice, vedere la Procedura PRINT o \a Specifica 
OCL PRINTER. 


Procedura o menù 
Per sostituire il nome di procedura più esterno (primo livello) che viene 
eseguito, vedere l'Espressione ?PPROC? (Procedura primo livello). 


Per sostituire il nome del corrente menù utente, vedere l'Espressione 
P2IMENU? (Menù corrente). 


Per far sì che venga visualizzato un menù, vedere la Specifica OCL MENU. 
Codice di ritorno 


Per controllare se una compilazione è riuscita, vedere l'Espressione ?CD? 
{Codice ritorno). 


ID utente 
Per sostituire l'ID utente dell'operatore che sta eseguendo ia procedura, vede- 


re l'Espressione ?PUSER? (ID utente dell'operatore). 


ID terminale 
Per sostituire l'ID di terminale che sta eseguendo ia procedura, vedere l'£- 


spressione ?WS? (ID unità video), 


Visualizzazione di messaggi o di tracciati video 


Tracciati video 
Per far comparire un tracciato video su una unità video che sta eseguendo la 


procedura, vedere la Specifica OCL PROMPT. 


Per determinare quale tasto di comando è stato premuto su uno schermo 
PROMPT, vedere l’Espressione ?CD? (Codice ritorno). 


Messaggi 
Per visualizzare un messaggio informativo suli’unità video che sta eseguendo 


la procedura, vedere la Specifica //* (Messaggio informativo). 


Per visualizzare un messaggio sulla console di sistema, vedere la Specifica 
//** (Messaggio console di sistema) . 


Per visualizzare un messaggio in quanto non è stato specificato un parametro 
indispensabile, vedere l'Espressione 2nR? (Parametro mancante), \'Espressione 
?R? (Parametro indispensabile) oppure l'Espressione ?nR‘mic‘? {Messaggio 
parametro mancante). 


Per visualizzare un messaggio e far compiere una pausa perchè l'operatore 
possa rispondere al messaggio, vedere la Procedura ERR o la Specifica 


PAUSE. 


Per specificare quale membro di messaggi deve essere usato, vedere la Speci- 
fica OCL MEMBER . 


Informazioni su file di dati 


Esistenza file 
Per determinare se un file di dati esiste sul sistema, vedere la Condizione 
DATAFI1 (File e librerie su disco). 


Per determinare se un file di dati esiste su minidisco, vedere la Condizione 
DATAI1 (File su. minidisco). 


| Per determinare se su un nastro o nastro a cassetta esiste un file di dati, vede- 
re la Condizione DATAT (File su nastro). 


Dimensioni dei file 
Per determinare la dimensione allocata di un file di dati, vedere l'Espressione 


?F’S,nome’? o ?F’S,nome,data”? (Dimensioni file), 


Per determinare il numero effettivo di record contenuti in un file di dati, 
vedere l'Espressione ?F'A,nome”? 0 ?2F‘A,nome,data’? . 


Spazio disponibile i 
Per determinare il numero di blocchi del disco disponibili, vedere la Cond/- 
zione BLOCKS (Spazio disponibile su disco). 
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Informazioni su librerie 


Nomi di libreria 
Per sostituire il nome della libreria corrente, vedere l’Espressione ?CL/B? 
(Libreria corrente). 


Per sostituire il nome detla libreria di sessione, vedere l’Espressione ?SL1/B? 
{Libreria di sessione). 


Per specificare una libreria, vedere la Procedura SLIB oppure la Specifica 
OCL LIBRARY. 


‘ Esistenza della libreria 
Per determinare se una libreria esiste sul sistema, vedere la Condizione 
DATAF1 (File e librerie su disco). 


Per determinare se una libreria esiste su un minidisco, vedere la Condizione 
DATAI1 (File su minidisco) . 


Per determinare se una libreria esiste su un nastro o nastro a cassetta, vedere 
la Condizione DATAT (File su nastro). 


Esistenza del membro 
Per determinare se esiste un membro origine nella libreria, vedere la Condi- 
zione SOURCE (Membri origine di libreria). 


Per determinare se un membro di procedura esiste in una libreria; vedere la 
Condizione PROC (Membri di procedura di libreria). 


Per determinare se esiste un membro di sottoroutine in una libreria, vedere la 
Condizione SUBR (Membri di sottoroutine di libreria). 


Per determinare se esiste un membro oggetto in una libreria, vedere la Condi- 
zione LOAD (Membri oggetto di libreria). 


Spazio disponibile 
Per determinare il numero dei blocchi del disco disponibili, vedere la Condi- 
zione BLOCKS [Spazio disponibile su disco). 


Informazioni su minidischi 


Volume ID 
Per sostituire l'ID di volume di un minidisco, vedere l'Espressione ?VOLID? 
o ?VOLID'locazione’? (ID Volume Nastro o Minidisco). 


Per verificare l'ID di volume di un minidisco, vedere la Condizione VOLID 
(ID Volume Nastro e Minidisco). 


Esistenza 


Per determinare se un file o una libreria esiste su un minidisco, vedere la 
Condizione DATA/1 (File su minidisco). 


Informazioni su nastri 
ID Volume ; 
Per sostituire "ID di volume di un nastro o nastro a cassetta, vedere l'Espres- 
sione ?VOLID? 0 ?VOLID'locazione”? (ID Volume Minidisco o Nastro). 


Per verificare l'ID Volume di un nastro o nastro a cassetta, vedere la Condizio- 
ne VOLID (ID Volume Minidisco e Nastro). 


Esistenza 
Per determinare se su un nastro o nastro a cassetta esiste un file o una libreria, 
vedere la Condizione DATAT (File su Nastro). 
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Confronti e valutazione di valori e salti nelle procedure 


Confronto 
Per verificare i valori di parametri o per verificare una o più condizioni, ve- 


dere le Espressioni condizionali IF. 


Per confrontare un'espressione con un’altra, vedere la Condizione Stringa1= 
stringa2 (Confronto, uguale a) o la Condizione stringa1>stringa2 (Confronto, 
maggiore di). 


Valutazione 
Per assegnare un valore ad un parametro, per aggiungere, sottrarre, moltiplica- 
re o dividere valori, per impostare l'espressione ?CD? (codice di ritorno)oppure 
per valutare espressioni di sostituzione, vedere la Specifica EVALUATE. 


Salto 
Per saltare ad un'altra specifica in una procedura, vedere le Specifiche GOTO 
e TAG. 


Prova della procedura o dell'ambiente di lavoro 


Tipo unità video 


Per determinare se una procedura viene eseguita dalla console di sistema, 


vedere la Condizione CONSOLE (Console di sistema). 


Coda lavori 
Per determinare se una procedura viene eseguita dalla coda di lavori, vedere 
la Condizione JOBO (Coda di lavori) . 


Procedura richiamata 
Per determinare se una procedura è stata avviata da una specifica OCL 
EVOKE o da Interactive Communications Feature (SSP-ICF), vedere la 
Condizione EVOKE (Procedure richiamate). 


Modo operativo di interrogazione 
Per determinare se una procedura viene eseguita durante il modo operativo 
di interrogazione, vedere la Condizione INQUIRY (Modo operativo di inter- 
rogazione). 


Richiedenti MRT 
Per determinare se una procedura per terminali richiedenti multipli (MRT) 
ha il numero massimo di terminali richiedenti collegati, vedere la Condizione 
MRTMAX (terminali richiedenti multipli) . 


Sottosistemi abilitati 
Per determinare se un sottosistema Interactive Communications Feature 
(SSP-ICF) è abilitato, vedere la Condizione ENABLED (Comunicazione abili- 
tata). 


Livello di riservatezza 
Per determinare se sul sistema è attiva la riservatezza con parola d'ordine, ve- 
dere la Condizione SECURITY (Riservatezza con parola d'ordine). 


Per determinare la classificazione di riservatezza di un operatore che esegue 
la procedura, vedere la Condizione SECURITY (Riservatezza con parola 
d'ordine). 


Esecuzione di procedure 
Per determinare se una o più procedure specificate sono correntemente in 


esecuzione sul sistema, vedere la Condizione ACTIVE (Esecuzione di proce- 
dura). 
Interruttori 


Gli interruttori sono anche chiamati indicatori da U1 a U8. Per determinare 
le regolazioni degli interruttori, vedere la Condizione SWITCH (Interruttori). 


Procedure di fine 


End 
Per cancellare una procedura, vedere la Specifica CANCEL. 


Per terminare una procedura nidificata e ritornare alla procedura richiamante, 
vedere la Specifica RETURN . 


Per terminare una procedura e richiamare la stessa o un'altra procedura, ve- 
dere la Specifica RESET. 
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SPECIFICA * (COMMENTO) 


Le specifiche di commento solitamente spiegano gli scopi delle specifiche stesse 
in una procedura. | commenti non sono visualizzati quando la procedura viene 
eseguita ma sono listati soltanto quando la procedura viene stampata o visualizzata. 


* Commenti 


commenti può essere qualsiasi combinazione di parole e di caratteri. L'asterisco 
deve essere immesso nella ‘colonna 1. Qualsiasi carattere che segue l'asterisco 
non viene elaborato quando la procedura viene eseguita. 


Esempio 1 


L'esempio mostra una specifica di commento come prima specifica in una proce- 
dura. 


* TESTA procedure 
// LOAD PROGI1 

// FILE NAME-INPUT 
// RUN 


Esempio 2 


Se ci sono molte specifiche di commento, inserire una specifica RETURN al ter- 
mine della procedura e disporre i commenti dopo RETURN. In questo modo il 
sistema elabora la specifica RETURN e i commenti non sono elaborati (rispar- 
miando così il tempo che il sistema altrimenti userebbe per leggerli). Per esempio: 


bfiesà 


so (specifiche nella procedura) 


(dA 


// RETURN 
* 


(commenti) 


* * * > 
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ESPRESSIONI DI SOSTITUZIONE 


Le espressioni di sostituzione consentono di sostituire informazioni nelle specifi- 
che elaborate quando la procedura viene eseguita. Esempi di informazioni che 
possono essere sostituite sono: 


® Parametri posizionali sulla specifica che ha richiamato la procedura. 


e Informazioni fornite dall'operatore in risposta ad una richiesta video o ad un 
messaggio inviato dall'interno della procedura. Se una procedura che invia 
messaggi è inserita nella coda dei lavori, i messaggi compaiono sulla console 
di sistema e l'operatore di sistema deve conoscere le risposte corrette. 


e Posizioni specificate nell’area di dati locale. (Per la spiegazione del modo in 
cui inserire i dati nell’area di dati locale, vedere la Specifica OCL LOCAL. 


Se una procedura che invia messaggi viene inserita nella coda dei lavori, i messag- 
gi compaiono sulla console di sistema e l'operatore di sistema deve conoscere le 
risposte corrette. 


Le espressioni di sostituzione possono essere usate immettendo le specifiche da 
tastiera o nelle specifiche di comando in un menù. In ogni caso, un'espressione di 
sostituzione per un parametro posizionale {una delle espressioni seguenti ?n?, 
?n‘valore’?, ?nT’valore’?, ?nF’valore’?, ?nR?, ?nR'mic'?) immessa da tastiera o 
contenuta in un menù si traduce in una sostituzione nulla e cioè non viene sosti- 
tuito alcun valore. Un’espressione di sostituzione per un parametro non posizio- 
nale si traduce nell’appropriata sostituzione. Per esempio, se si stesse immettendo 
la seguente specifica dalla tastiera: 


// FILE NAME-?2'FILEA!'? ,DATE-?DATE? 


Se la data corrente è 021480, viene generata la seguente specifica: 


// FILE NAME-,DATE-021%80 


Le specifiche di commento che sono indicate da un asterisco (*} nella posizio- 
ne 1 della specifica, non sono completamente elaborate dal SSP; pertanto, nelle 
specifiche di commento la sostituzione non viene eseguita. La sostituzione si veri- 
fica ogniqualvolta si incontra un'espressione valida, anche se l’espressione è nella 
parte commenti di una specifica OCL. 


Le espressioni di sostituzione iniziano e terminano sempre con un punto interrogati- 
vo. Un'’espressione di sostituzione inizia ogni volta che un punto di domanda è se- 
guito immediatamente da un numero o da uno dei seguenti caratteri: C, D, F, L, M, 
P,R,S,T,U,V,0W. Ciò significa che per esempio, se si specifica ?C in una proce- 
dura, questa verrà sempre elaborata come espressione di sostituzione. Viene visua- 
lizzato un messaggio di errore quando si immette un ?C come parte di qualcosa. Un 
punto di domanda seguito da qualsiasi altro carattere non è trattato come un’espres- 
sione di sostituzione. 


Quelle che seguono sono descrizioni di espressioni di sostituzione che possono 
essere usate in una procedura. Sono inclusi anche esempi dell'uso delle espressio- 
ni di sostituzione. 
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Espressione ?n? (Parametro) 


Questa espressione sostituisce il valore dell’n-esimo parametro posizionale. Se |n- 
esimo parametro posizionale non ha un valore, non viene sostituito alcun valore, 


n è un numero da 1 a 64 che specifica il parametro da sostituire. 
Per esempio, si abbia una procedura che contiene la seguente specifica: 

// * *23? WAS DELETED! 
Se il terzo parametro non ha un valore (e cioè non è stato specificato sulla speci- 
fica di procedura e non gli è stato assegnato un valore da una precedente specifi- 
ca nell’ambito di questa procedura), viene generata la seguente specifica: 

//* * WAS DELETED' 


Se il valore del terzo parametro è FILEX, viene generata la seguente specifica: 


// * ‘FILEX WAS DELETED' 


Espressione ?n‘valore’? (Parametro assunto per difetto) 


Questa espressione sostituisce il valore dell’n-esimo parametro posizionale, oppure 
se l’n-esimo parametro non ha un valore, l’espressione assegna permanentemente 
un valore assunto per difetto al parametro e quindi sostituisce quel valore. 


n è un numero da 1 a 64 che specifica il parametro da sostituire. 


valore specifica il valore da assegnare al parametro se il parametro corrente non 
ha alcun valore. Qualsiasi successivo riferimento all’n-esimo parametro nell’ambito 
della procedura, userà il valore assegnato. 


Per esempio, una procedura contiene la specifica seguente: 
// FILE NAME-?2'FILEA!? 

Se il secondo parametro non ha un valore viene generata la seguente specifica: 
/} FILE NAME-FILEA 


Questo esempio mostra come i riferimenti del secondo parametro che seguono 
l’espressione assunta per difetto usino a loro volta il valore FILEA. 


// FILE NAME-?2'FILEA!'? 
* 


* 
// FILE NAME-?22 


Se il secondo parametro non ha valore, vengono generate le seguenti specifiche: 


// FILE NAME-FILFA 
* 


* 
// FILE NAME-FILEA 


Espressione ?nT‘valore’? (Parametro valore temporaneo) 


Questa espressione sostituisce il valore dell’n-esimo parametro posizionale; oppure 
se l’n-esimo parametro non ha un valore, l’espressione assegna temporaneamente 
un valore al parametro e quindi sostituisce il valore. 


n è un numero da 1 a 64 che specifica il parametro da sostituire. 
T indica il valore che è temporaneamente assegnato al parametro. 


valore specifica il valore temporaneo. Un valore temporaneo è usato soltanto per 
l'espressione di sostituzione corrente. Per gii altri riferimenti al parametro n-esimo 
nell’ambito della procedura, il parametro non ha un valore. 


Per esempio, una procedura contiene le seguenti specifiche: 


// FILE NAME-?2T'FILEA!? 
// * *THE SECOND PARAMETER IS ?2T'NOT DEFINED: FILEA ASSUMED'?' 


/] * *THE SECOND PARAMETER IS NOW ?22! 


Se il secondo parametro non ha un valore, vengono generate le seguenti speci- 
fiche: 


// FILE NAME-FILEA 
// * ‘THE SECOND PARAMETER IS NOT DEFINED: FILEA ASSUMED' 
//* ‘THE SECOND PARAMETER IS NOW ' 


Notare che l’espressione ?2? nell'ultima specifica ha sostituito il valore originale 
del parametro 2 che era uno spazio vuoto. 


Se il secondo parametro era FILEC, vengono generate le seguenti specifiche: 


// FILE NAME-FILEC 
// * 'THE SECOND PARAMETFR IS FILEC' 
// * *'THE SECOND PARAMETER IS NOW FILEC' 


Espressione ?nF‘valore’? (Parametro valore forzato) 


Questa espressione forza immediatamente un nuovo valore da assegnare all’n-esi- 
mo parametro posizionale se i'n-esimo parametro posizionale ha un valore. 


n è un numero da 1 a 64 che specifica il parametro da sostituire. 


F indica il valore da assegnare al parametro, indipendentemente dal valore corren- 
te dei parametro stesso. e 


valore specifica il valore che deve essere sostituito nella specifica che contiene 
l'espressione. 


Per esempio una procedura contiene le seguenti specifiche: 


// LOAD PROGI 

// FILE NAME-INPUT,LABEL-?3F'FILEA'? 
// RUN 

// LOAD PROG2 

// FILE NAME-INPUT,LABEL-?3? 

// RUN 
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Vengono generate le seguenti specifiche, indipendentemente dal valore del para- 
metro 3 prima che il programma PROGI1 fosse caricato. 


// LOAD PROGI 

// FILE NAME-INPUT,LABEL-FILEA 
// RUN 

// LOAD PROG2 

// FILE NAME-INPUT,LABEL-FILEA 
// RUN 


Per modificare un parametro in modo che abbia più di un valore, è possibile spe- 
cificare quanto segue: 


înF''!? 


Espressione ?R? (Parametro indispensabile) 

Questa espressione visualizza il messaggio: 

Immettere il parametro richiesto 
e attende che l'operatore immetta (da tastiera) il valore da sostituire, R indica 
che è indispensabile una risposta dell'operatore. E’ possibile immettere fino a 60. 
caratteri in risposta al messaggio. Per esempio, una procedura contiene la seguen- 
te specifica: 

// FILE NAME-?R? 
Quando s'incontra la specifica, viene visualizzato il messaggio Immettere il para- 
metro richiesto. L'operatore quindi batte FILEA dalla tastiera, preme il tasto 
Entr/Avanz Rec e viene generata la seguente specifica: 


// FILE NAME-FILEA 


Per maggiori informazioni vedere Parametri di Procedura. 


Espressione ?nR? (Parametro mancante) 


Questa espressione sostituisce il valore dell’n-esimo parametro posizionale; oppure 
se l’n-esimo parametro non ha un valore, visualizza un messaggio: 


Immettere il parametro mancante 
ed attende che l'operatore immetta (dalla tastiera) il valore da sostituire. | riferi- 
menti all’n-esimo parametro che seguono questa espressione usano il valore im- 
messo dall'operatore. E' possibile immettere fino a 60 caratteri in risposta al 
messaggio. 
n è un numero da 1 a 64 che specifica il parametro da sostituire. 
R indica che il parametro è indispensabile. 
Per esempio una procedura contiene la specifica seguente: 

// FILE NAME-INPUT,LABEL-?1R? 
Se il primo parametro non ha un valore, viene visualizzato il messaggio Immettere 
il parametro mancante. L'operatore quindi immette FILEA dalla tastiera e viene 


generata la specifica seguente: 


// FILE NAME-INPUT,LABEL-FILEA 


Per maggiori informazioni vedere Parametri di Procedura. 


Veni 


Espressione ?R'mic’? (Messaggio parametro indispensabile) 


Questa espressione visualizza un messaggio dal membro messaggi utente di primo 
livello e attende che l'operatore immetta il valore da sostituire. E’ possibile im- 
mettere fino a 60 caratteri in risposta al messaggio. Vedere la Specifica OCZ 
MEMBER per informazioni su.i‘»ssegnazione di un membro di messaggi ad una 
procedura. Vedere la Procedura CREATE per le informazioni sulla creazione di 
un membro di messaggi. 


R indica che il parametro è indispensabile. 
mic identifica il codice d'identificazione messaggio de! messaggio da visualizzare. 
Per esempio, una procedura contiene le seguenti specifiche: 


// MEMBER USER1-MESSAGES 
// LOAD PROGA 

// FILE NAME-?R'0015'? 
// RUN 


Quando questa specifica viene elaborata, il SSP visualizza il messaggio 0015 dal 
membro di messaggi di primo livello corrente denominato MESSAGES: 


Immettere il nome del file: 


L'operatore immette quindi la parola PAYROLL dalla tastiera e viene generato 
quanto segue per la specifica OCL FILE: 


// FILE NAME-PAYROLL 


Per maggiori informazioni vedere Parametri di Procedura. 
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Espressione ?nR’mic’? (Messaggio parametro mancante) 


Questa espressione sostituisce il valore dell’n-esimo parametro posizionale; oppure 
se l'm-esimo parametro posizionale non ha un valore, visualizza un messaggio dal 
membro messaggi di primo livello e attende che l'operatore immetta il valore da 
sostituire. E’ possibile immettere fino a 60 caratteri in risposta al messaggio. | 
riferimenti all’n-esimo parametro che seguono questa espressione, usano’ il valore 
immesso dall'operatore. 


Vedere ia Specifica OCL MEMBER per le informazioni sull’assegnazione di un 
membro di messaggi ad una procedura. Vedere la Procedura CREATE per infor- 
mazioni sulla creazione di un membro di messaggi. 


n è un numero da 1 a 64 che specifica il parametro da sostituire. 
R indica che il parametro è indispensabile. 


mic identifica il codice d’indentificazione del messaggio da visualizzare se l’n-esi- 
mo parametro non ha un valore, i 


Per esempio, una procedura contiene le seguenti specifiche: 


// MEMBER USER1-MESSAGES 
// LOAD PROGA 

// FILE NAME-?1R'0015'? 
// RUN 

// * *'FILE ?1? WAS USED' 


Se il primo parametro non viene immesso, viene visualizzato il messaggio 0015 
dal membro di messaggi di primo livello: 


Inmettere il nome del file: 


L'operatore immette quindi la parola PAYROLL e viene generato quanto segue 
per la specifica OCL FILE: 


// FILE NAME-PAYROLL 


Per maggiori informazioni vedere Parametri di Procedura. 


Espressione ?Cn? (Lunghezza parametro) 


Questa espressione sostituisce la iunghezza deli’n-esimo parametro posizionale, 
Il risultato della sostituzione è un numero di tre cifre con zeri non significativi. 


C indica che l'informazione di lunghezza dei caratteri viene sostituita. 
n è un numero da 1 a 64 che specifica il parametro da sostituire. 
Per esempio, si abbia una procedura che contiene la seguente specifica: 


// IF 2202>8  * ‘22? HAS MORE THAN 8 CHARACTERS' 


Se il parametro 2 avesse un valore di FILEABCDE, verrebbe generata la seguente 
specifica: 


// IF 009>8 * 'FILEABCDE HAS MORE THAN 8 CHARACTERS! 


Espressione ?C’valore’? (Lunghezza) 


Questa espressione sostituisce la lunghezza del valore specificato. Il risultato della 
sostituzione è un numero di tre cifre con zeri non significativi. 


C indica che l'informazione di lunghezza dei caratteri viene sostituita. 
valore specifica il valore la cui lunghezza deve essere sostituita. Se il valore è mi- 
nore di 0, nella lunghezza è incluso il segno meno. Per esempio, —23 ha una lun- 
ghezza di 003. 
Per esempio, si abbia una procedura che contiene la seguente specifica: 

// * *?USER? HAS ?C0'?USER?'? CHARACTERS' 


Se l'operatore avesse un ID di SUSAN, verrebbe generata la seguente specifica: 


// * *SUSAN HAS 005 CHARACTERS' 
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Espressione ?CD? (Codice di ritorno) 


Questa espressione consente di controllare le condizioni in una procedura e sosti- 
tuisce un codice di ritorno dì 4 caratteri impostato dal SSP, da un programma su 
licenza o da una procedura che usa la specifica EVALUATE. | possibili codici 
di ritorno, sono: 


Codice di Significato 
ritorno 


Il precedente passo di lavoro è terminato normalmente o questo passo è il primo nel 
lavoro. Questo valore è ritornato anche quando viene premuto il tasto Entr/Avanz.Rec 
su una specifica OCL PROMPT. 


Sono stati trovati errori di avvertimento nella compilazione COBOL. 


















Sono stati trovati errori condizionali nella compilazione COBOL. 




















Sono stati trovati seri errori nel precedente passo di lavoro (procedure ASM, COBOL, 
FORMAT, FORTANC, OLINK, RPGC o WSU). 


In risposta alla procedura ERR, l'operatore ha preso l'opzione 0. 








1010 
1011 
1012 
1312 








In risposta alla procedura ERR, l'operatore ha preso l'opzione 1. 








In risposta alla procedura ERR, l'operatore ha preso l’ozione 2. 








II precedente passo di lavoro era un programma MRT che è terminato senza rilasciare 
l’unità video. 
La procedura HELP è stata cancellata dall'operatore premendo il tasto di comando 7. 
Tasti di comando da ‘1 a 24 ritornati dallo schermo della specifica OCL PROMPT. 
2001 significa tasti di comando 1, 2002 significa tasto di comando 2, ... 2024 significa 
tasti di comando 24. ; 

Il file specificato sulla specifica OCL FILE non è disponibile. E’ attualmente usato da un 
programma sospeso, da un programma con l'attributo di programma sempre residente in 
memoria, da un lavoro in attesa a causa di una specifica OCL WAIT o da un lavoro che 
ha acquisito il file usando una specifica OCL FILE al di fuori di una coppia di specifiche 
OCL LOAD e RUN. 


E’ attualmente in uso il file indicato sulla specifica OCL FILE. E’ possibile tentare di 
nuovo di allocare il file. 
Il modulo minidischi indicato dalla specifica OCL ALLOCATE non è disponibile. Esso è 
attualmente usato da un programma sospeso, da un programma con l'attributo di pro- 
gramma sempre residente in memoria, da un lavoro in attesa a causa di una specifica 
OCL WAIT o da un lavoro che ha usato la specifica OCL ALLOCATE per allocare il 
modulo. 
















1991 
2001-2024 









































E’ attualmente in uso il modulo a minidischi indicato dalla specifica OCL ALLOCATE. 
E’ possibile tentare di nuovo di allocare il modulo. Si 


















Sono stati trovati errori dalla procedura CREATE (il programma di utilità $SMGBLD), 


L'unità a nastro 1 indica nella specifica OCL ALLOCATE non è disponibile. E’ attual- 
mente usata da parte di un programma sospeso, da un programma sempre residente in 
memoria, da un lavoro in attesa a causa di una specifica OCL WAIT o da un lavoro che 
ha usato la specifica OCL ALLOCATE per allocare l'unità. 


L'unità a nastro 1 indicata dalla specifica OCL ALLOCATE è attualmente in uso. E' pos- 
sibile successivamente cercare di allocare l’unità. 


L'unità a nastro 2 indicata dalla specifica OCL ALLOCATE non è disponibile. Essa è 
attualmente usata da un programma sospeso o da un programma sempre residente in 
memoria o da un lavoro in attesa a causa di una specifica OCL WAIT o da un lavoro 
che ha usato la specifica OCL ALLOCATE per allocare l’unità. 


L'unità a nastro 2 indicata dalla specifica OCL ALLOCATE è attualmente in uso, E' 
possibile successivamente cercare di allocare l’unità, i 



































Figura 4. (Parte 1 di 2) - Definizione dei codici di ritorno ?CD? 


Sa 


Codice di Significato 
ritorno ° 





2040 La stampante specificata nella specifica OCL PRINTER è già continuata dal parametro 
CONTINUE-YES. 
2041 L'unità nastro a cassetta indicata dalla specifica OCL ALLOCATE è attualmente usata da 


un programma in attesa, un programma con attributo di senza fine, o un lavoro in attesa 
a causa di una specifica OCL WAIT, o un lavoro che ha utilizzato ia specifica ALLOCATE 
per allocare l’unità. 








2042 L'unità nastro a cassetta indicata dalla specifica OCL ALLOCATE è correntemente in uso. 


Si può tentare di allocare l’unità in un secondo momento. 





L'unità nastro a cassetta o l’unità minidisco indicate dalla specifica OCL ALLOCATE, non 
sono disponibili. L'unità nastro a cassetta o l'unità minidisco sono utilizzate da una comu- 
ne risorsa non condivisibile di sistema in attesa. 


2043 














L'unità nastro a cassetta o l'unità minidisco indicate dalla specifica OCL ALLOCATE, non 
sono disponibili. 

L'unità nastro a cassetta o l’unità minidisco sono utilizzate da una comune risorsa non con- 
divisibile di sistema in attesa; o è utilizzata da un programma în attesa, un programma con 
attributo di senza fine, o un lavoro in attesa a causa di una specifica OCL WAIT, o un lavo- 
ro che ha utilizzato la specifica ALLOCATE per allocare l’unità. 


2090 Tasto Roli Up (È) dalla specifica OCL PROMPT. 
2091 Tasto Roll Down (.£) dalla specifica OCL PROMPT. 
2092 Tasto RICH AIUTO dalla specifica OCL PROMPT. 


2093 Tasto arretramento record dalla specifica OCL PROMPT. (II tasto RIT CURS è stato 
premuto mentre il cursore era in posizione di partenza). 


2044 

































2143 


3721 L'operatore ha cancellato il precedente passo di lavoro selezionando l'opzione 2 in rispo- 
sta ad un messaggio oppure il passo precedente era un programma MRT e l'operatore ha 
rilasciato l'unità video interrompendo il programma MRT (premendo il tasto Atten) e 
quindi scegliendo l'opzione 2. 


La procedura HELP è stata cancellata dall'operatore premendo il tasto di comando 3. 








8158 La sessione SSP-ICF è terminata anormalmente. 


Figura 4, (Parte 2 di 2) - Definizione dei codici di ritorno ?2CD? 


Nell'esempio seguente, se il codice di ritorno è uguale a 1008. viene inviato un 
messaggio all'unità video che ha avviato la procedura. 


// IF 2CD?=1008 MSG ?WS?,'AN ERROR OCCURRED DURING THE COMPILE' 


Il SSP ripristina il codice di ritorno a 0000 ogniqualvolta elabora una specifica 
OCL RUN. 


Espressione ?CLIB? (Libreria corrente) 


Questa espressione sostituisce il nome della libreria corrente. Vedera la Specifica 
OCL LIBRARY per ulteriori informazioni sulla libreria corrente. Per esempio, 
una procedura contiene le seguenti specifiche: 


// LIBRARY NAME-MYLIB 
// JOBQ ?CLIB?, PROC 


Viene generata la seguente specifica JOBO: 
// 30BQ MYLIB,PROC 


La libreria corrente è quella che è attualmente attiva. La libreria corrente è deter- 
minata quando si.elabora la specifica OCL LIBRARY nell'ambito di una proce- 
dura. 
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Espressione ?DATE? (Data programma) 


Questa espressione sostituisce la data del programma corrente. Per esempio, una 
procedura contiene la seguente specifica: 


/)] FILE NAME-FL?DATE? 


Se la data corrente del programma è 021483, viene generata la specifica seguente. 
Notare che il formato è quello della data della sessione corrente: 


/] FILE NAME-FL021183 


Espressione ?‘F’'S,nome’? oppure ?F‘S,nome,data’'? (Dimensione file) 


Questa espressione sostituisce il numero di blocchi o di record riservati (o alloca- 
ti) per un file su disco residente (T). Il valore sostituito è indicato nelle unità 
(blocchi o record) specificate al momento della creazione del file. Il risultato del- 
la sostituzione è Un numero di 8 cifre con zeri non significativi. Se i file non esi- 
stono sul disco, oppure se il file è un file di lavoro (J) o un file temporaneo (S), 
viene sostituito 00000000. Se esistono due o più file sul disco con lo stesso no- 
me ma non viene specificata alcuna data, viene sostituita la dimensione del file 
con la data di creazione più recente. 


Il valore sostituto è quello usato originariamente per allocare, riservare o creare il 
file. Se il file era stato creato come RECORDS-00001210, il valore di ritorno è 
0001210 non l'ampiezza attuale del file che sarà normalmente più grande arroton- 
dato al blocco superiore. 


Se si vuole utilizzare ?F'S per creare un altro file di uguale ampiezza, si devono cal- 
colare anche i record che riempiono un blocco o usare blocks per allocare spazio. 


F indica che sono sostituite le informazioni di dimensioni del file. 
S indica che viene sostituita la dimensione allocata. 
nome è il nome del file. 
data è la data di creazione del file. 
Per esempio, una procedura contiene la seguente specifica: 
// FILE NAME-FILEB,BLOCKS-?F'S,FILEA'? 


Se è stato creato FILEA con una dimensione di 50 blocchi, verrà generata la se- 
guente specifica per FILEB: 


// FILE NAME-FILEB,BLOCKS-00000050 


Questo tipo di sostituzione, quando usato con una specifica OCL FILE, potrebbe 
risultare errato se il file non esiste. 


Espressione ?F‘A,nome'? oppure ?F‘A,nome,data'? (Dimensione effettiva 
del file) 


Questa espressione sostituisce il numero effettivo di record di dati contenuti in 
un file su disco residente {(T). ll risultato della sostituzione è un numero di 8 
cifre con zeri non significativi. Se il file non esiste sul disco oppure se il file è un- 
file di lavoro (4) o un file temporaneo ($), viene sostituito 00000000. Se esistono 
due o più file sul disco con lo stesso nome e non viene specificata alcuna data, 
viene sostituita la dimensione del file con fa data di creazione più recente. 

F indica che sono sostituite le informazioni di dimensioni del file. 

A indica che viene sostituito il numero effettivo di record. 

nome è il nome del file. 

data è la data di creazione del file, 

Per esempio, una procedura contiene la seguente specifica: 


// FILE NAME-FILEB,RECORDS-?F'A,FILFA!? 


Se FILEA contiene effettivamente 150 record di dati, viene generata la seguente 
specifica che crea FILEB con una dimensione di 150 record: 


// FILE NAME-FILEB,RECORDS-00000150 


Questi tipi di sostituzione, se usati con una specifica OCL FILE, potrebbero 
risultare errati se il file non esiste oppure se il file è vuoto. 


Il numero di record sostituiti non rispecchia nessun record aggiunto da un utente 


che sta in quel momento utilizzando il file. La VTOC non viene aggiornata fino a 
che l’ultimo utente non ha terminato di utilizzare il file. 


86.1 





86,2 








.. Pagina lasciata intenzionalmente bianca 


î 


o È 

















SR 


Espressione ?L'posizione,lunghezza'? (Area Dati Locale) 


Questa espressione sostituisce un valore dell'area dati locale dell'unità video di 
512 byte. Per informazioni sulla modifica dell’area dati locale dell'unità video, 
vedere la Specifica OCL LOCAL. | dati sono sostituiti dall'area dati locale dell'u- 
tentr del sistema in relazione all'ultimo parametro AREA della specifica OCL 
LOCAL. Se non era stato specificato alcun precedente parametro AREA, viene 
presunta l’area dati locale dell'utente. L'area dati locale di sistema è usata dalle 
procedure fornite dalla IBM e qualsiasi dato inserito nell'area dati locale del si- 
stema può andare perso. Se si richiama una procedura fornita dalla IBM che usa 
l'area dati locale di sistema, i dati dell'area dell'utente non sono interessati. Inol- 
tre, l'area dati locale che viene usata quando si richiama una procedura IBM è ri- 
conosciuta come area dati locale da usare quando termina la procedura richia- 
mata. 


L indica che un valore è sostituito dall'area dati locale. 


posizione specifica la posizione iniziale (un numero da 1 a 512, dove 1 specifica 
la prima posizione) dell’area dati locale da sostituire. 


lunghezza specifica il numero di posizioni nell’area dati locale da sostituire. Sono 
ammessi spazi vuoti di inizio e spazi vuoti incorporati (spazi vuoti all'interno dei 
caratteri che vengono sostituiti, per esempio, SZABC DEF’) nel valore sostituito ma 
non sono sostituiti gli spazi vuoti di coda. 


Per esempio, una procedura contiene la specifica seguente: * 


// FILE NAME-INPUT,LABEL-?L'12,8'?,UNIT-F1 


Se 8 posizioni da 12 a 19 dell'area dati locale contengono ‘FILEA', viene genera- 
ta la seguente specifica: 


// FILE NAME-INPUT,LABEL-FILEA,UNIT-F1 


Se i dati sostituiti sono quindi usati in un'espressione o specifica che ha una limi- 
tazione di lunghezza, i dati devono rispettare quella limitazione. 
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Espressione ?Mmic? oppure ?M'mic,posizionelunghezza'? (Membro di mes- 
saggi) 


Questa espressione sostituisce un valore di una specifica del membro di messaggi 
di primo livello (USER1). Per informazioni sull’assegnazione di un membro di 
messaggio, vedere la Specifica OCL MEMBER. 


M indica che un valore è sostituito da una specifica nel membro di messaggi. 


mic specifica il codice di identificazione messaggio del messaggio contenente il 
valore da sostituire. 


posizione specifica la posizione (un numero decimale da 1 a 75, dove 1 specifica 
la prima posizione) nel testo di messaggio da cui iniziare la sostituzione. 


lunghezza specifica il numero decimale di posizioni del valore da sostituire. 


Se non sono specificati posizione e lunghezza, viene sostituito l'intero testo del 
messaggio. Gli spazi vuoti d'inizio e gli spazi vuoti incorporati (spazi vuoti all’in- 
terno dei caratteri che vengono sostituiti, ad esempio, ‘ABC DEF'), sono ammessi 
nel valore sostituito ma gli spazi vuoti di coda sono troncati. Per esempio, una 
procedura contiene la seguente specifica: 


// * *2M'001k,10,8'? WAS USED' 


Se 8 posizioni da 10 a 17 del messaggio 0014 contengono ‘FILEA, viene generata 
la seguente specifica: 


// * ‘FILEA WAS USED' 


Se i dati sostituiti vengono quindi usati in un'espressione o specifica che ha una 
limitazione di lunghezza, i dati devono rispettare quella limitazione. 


Espressione ?MENU? (Menù corrente) 


Questa espressione sostituisce il nome di menù da 1 a 6 caratteri del menù del. 
l'utente correntemente attivo. Se non è correntemente attivo alcun menù dell’u- 
tente, non viene sostituito alcun valore. 


Per esempio, si abbia una procedura che contiene la seguente specifica: 


// IF ?®MENU?=SAMPLE MENU MINE 


Se il menù denominato SAMPLE è correntemente attivo, la prova sarà vera e ver- 
rà elaborata la specifica OCL MENU per visualizzare il menù MINE. Se il nome 
del menù non è denominato SAMPLE, la specifica MENU non viene elaborata. 


Espressione ?PRINTER? (Stampatrice di sessione) 
Questa espressione sostituisce il valore di 2 caratteri che indica la stampatrice di 
sessione. Viene usata la procedura SET o PRINT per impostare la stampatrice di 
sessione; vedere /a Procedura SET o la Procedura PRINT. 
Per esempio, una procedura contiene la sequente specifica: 
// SYSLIST ?PRINTER? 
Se l'ID della stampatrice di sessione è P2, viene generata la seguente specifica: 


// SYSLIST P2 


Se la stampatirce di sessione è definita di sistema, la stampatrice di sistema viene 
sostituita. 


Espressione ?PROC? (Procedura di primo livello) 
Questa espressione sostituisce il nome da 1 a 8 caratteri della procedura di primo 
livello che viene eseguita. La procedura di primo livello è la prima richiamata 
in una serie di procedure nidificate. Per esempio, una procedura contiene la se- 
guente specifica: 


// * '?PROC? IS RUNNING! 


Se il nome della procedura di primo livello è PROCABC, viene generata la se- 
guente specifica. 


// * *'PROCABC IS RUNNING' 


Espressione ?SLIB? (Libreria di sessione) 
Questa espressione sostituisce il nome della libreria attiva per la sessione. Per 


esempio, la libreria di sessione è MYLIB e una procedura contiene la specifica 
seguente: 


// JOBQ ?SLIB?,PROCEDUR 
Viene generata la seguente specifica: 


// JOBQ MYLIB,PROCEDUR 


La libreria di sessione è quella che è attiva alla tastiera. La libreria di sessione 
viene creata quando: 


e Cisicollegaal sistema 
e Si esegue la procedura SLIB 
© Si immette la specifica OCL LIBRARY da tastiera 


e Si immette il comando MENU con il nome della libreria. 


Espressione ?SYSLIST? (Unità di lista di sistema) 
Questa espressione sostituisce il valore di 2-3 caratteri che indica dove viene vi- 
sualizzata o stampata l'emissione di lista di sistema. Le procedure SYSLIST e RA 
PRINT sono usate per impostare l’unità di lista del sistema, vedere la Procedura 
SYSLIST o la Procedura PRINT. | valori sostituiti sono: 
OFF se l’unità di lista di sistema corrente è disattivata 


CRT se l'emissione di lista di sistema è impostata a CRT 


id stampatrice (un ID di stampatrice a 2 caratteri) se l'emissione di lista di siste- 
ma è impostata ad una stampatrice. 


Per esempio, una procedura contiene la seguente specifica: 
// IF ®SYSLIST?=CRT SYSLIST ®PRINTER? 


Se l’unità di lista di sistema è CRT e se la stampatrice di sessione è P2, viene ge- 
nerata la seguente specifica: 


// IF CRT=CRT SYSLIST P2 


Se l'unità di lista di sistema è SYSTEM e non è definita una stampatrice di sistema, 
CRT viene sostituito. 


Espressione ?TIME? (Ora di sistema) 
Questa espressione sostituisce l'ora di sistema corrente nel formato: HHMMSS, 
dove HH sono le ore, MM sono i minuti e SS sono i secondi, L'ora del sistema 
è basata sull’ora in cui l'operatore entra nel sistema durante il caricamento del 
programma iniziale (IPL). Ad esempio una procedura contiene la specifica se- 
guente: 
// * "THE TIME IS ?TIME?! 


Se l'ora corrente del sistema è 9:45:24, viene generata la seguente specifica: 


// * 'THE TIME IS 09k52h' 


Espressione ?USER? (ID utente dell'operatore) 
Questa espressione sostituisce l'ID dell'utente da 1 a 8 caratteri assegnato all’ope- 
ratore che ha avviato il lavoro. Per esempio, una procedura contiene la specifica 
seguente: 
// LOCAL DATA-'?USER?! 
Se l'ID dell'utente dell'operatore è MIKE, viene generata la seguente specifica: 


// LOCAL DATA-'MIKE' 


Per le procedure MRT, vengono sostituiti degli spazi vuoti all'espressione ?PUSER?. 


Espressione ?VOLID? o ?VOLID'locazione’? (ID volume minidisco o 
nastro) 


Questa espressione sostituisce 1"ID di volume (da 1 a 6 caratteri) del minidisco o 
del nastro nella locazione specificata. Usare questa espressione con cautela perché 
è possibile modificare o cancellare il minidisco o il nastro sbagliato. 


locazione specifica le posizioni di caricatore, di alimentatore o di unità nastro in cui 
cercare i minidischi o i nastri. Su un sistema senza un caricatore, una qualsiasi 


locazione di minidisco si risolve in S1. La locazione può essere una qualsiasi 
fra le seguenti: 


S1 specifica l'ID di volume del minidisco nell’alimentatore 1, Se non è 
immessa alcuna locazione, questa locazione viene assunta per difetto. 


S2 specifica l'ID di volume del minidisco nell’alimentatore 2. 
S3 specifica l'ID di volume del minidisco nell'alimentatore 3. 


M1.nn specifica ID di volume del minidisco nel caricatore 1, posizione 
nn. ove nn può essere qualsiasi numero da 01 a 10. 


M2.nn specifica ID di volume del minidisco nel caricatore 2, posizione nn. 
ove nn può essere qualsiasi numero da 01 a 10. 


T1 specifica l'ID di volume del nastro sull'unità nastro 1. 


T2 specifica l'ID di volume del nastro sull'unità nastro 2. 


TC specifica I'D di volume dei nastro a cassetta sull'unità nastro. 


Per esempio una procedura contiene la seguente specifica: 





//* *THE VOLUME ID OF THE DISKETTE IS ?VOLID'M1.02'?! 


Se l'ID di volume del minidisco nel caricatore 1, posizione 2 è VOL001, viene 
generata la seguente specifica: 


// * 'THE VOLUME ID OF THE DISKETTE IS VOLOOl! 


Usare questa espressione con cautela. E’ possibile saltare il normale controllo di 
ID di volume che è inteso ad assicurare che venga usato l'appropriato minidisco o 
nastro. 


Espressione ?WS? (ID unità video) 


Questa espressione sostituisce ID di terminale di 2 caratteri dell'unità video che 
ha richiamato la procedura. Per esempio, una procedura contiene la seguente spe- 
cifica: 


// FILE NAME-INPUT,LABEL-FILEA?WS? 


Se la procedura è richiamata dal terminale W3, viene generata la seguente speci- 
fica: 


// FILE NAME-INPUT,LABEL-FILEAW3 


Se la procedura viene eseguita dalla coda di lavori, il SSP sostituisce l'ID dell'uni- 
tà dalla quale il lavoro è stato inserito nella coda. 


Se la procedura viene eseguita usando la specifica OCL EVOKE, il SSP sostituisce 
IID dell'unità video dal iavoro che ha emesso i! richiamo. Se la procedura viene 
eseguita usando l'operazione di richiamo dell’Interactive Communications Feature 
(SSP-ICF), il SSP sostituisce l'ID di sessione SSP-ICF (da 00 a 99). 
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ESPRESSIONI DI SOSTITUZIONE NIDIFICATE 


E’ possibile nidificare espressioni di sostituzione {e cioè avere espressioni di sosti- 
tuzione che richiamano altre espressioni di sostituzione. Per esempio una proce- 
dura contiene fa specifica seguente: 


2M'0014,1,29'? 


Questa espressione specifica che i primi 29 caratteri del messaggio numero 0014 
devono essere sostituiti. In questo esempio, i primi 29 caratteri del messaggio 
0014, sono, 


// FILE NAME-FILEA?WS? 


Pertanto, la specifica che risulta dalla prima espressione di sostituzione, contiene 
un'altra espressione di sostituzione. Il SSP elabora quindi quest’ultima espressio- 
ne. Se {"ID dei terminale dell'unità video che ha avviato il lavoro è W1, la specifi- 
ca risultante è: 


// FILE NAME-FILEAWI 


x 


Usando le espressioni nidificate è possibile usare un'espressione di sostituzione 
come valore assunto per difetto nell’ambito di un'altra espressione. Per esempio: 


91!929!? 


fornisce al SSP le istruzione per sostituire il valore del primo parametro. Se il pri- 
mo parametro non ha un valore, il SSP sostituisce il valore del secondo para- 
metro. 


Usando espressioni di sostituzioni nidificate, fare attenzione ad evitare espressioni 
che potrebbero provocare un'iterazione infinita. Per esempio, una procedura con- 
tiene la seguente specifica: 


// FILE NAME-?1R? 


Se l'operatore non ha specificato il primo parametro, viene visualizzato un mes- 
saggio che dice all'operatore di immettere il valore. Se l'operatore immette ?1?, il 
SSP continuerà a sostituire ?1? nella specifica. L'operatore dovrà interrompere e 
quindi cancellare la procedura. 


Si può avere un numero illimitato di espressioni di sostituzione nidificate in ciascuna 
specifica. i 


ESPRESSIONI CONDIZIONALI IF 


Le espressioni condizionali nell'ambito di una procedura, consentono di elaborare 
condizionalmente talune specifiche di controllo di programma di utilità e OCL 
quando la procedura viene eseguita. 


L'espressione IF può essere usata soltanto nell’ambito di una procedura. Un'e- 
spressione IF prova una condizione specificata; se la condizione è soddisfatta, la 


specifica indicata viene elaborata. 


Le espressioni IF possono avere una qualsiasi dei seguenti formati: 


// IF. condizione specifica 
oppure 
// IFT condizione specifica 


oppure 


// IFF condizione specifica 








IF e IFT provano se la condizione specificata da condizione è vera. Se la condi- 
zione specificata è vera, viene elaborata la specifica che segue la condizione. 


IFF prova se la condizione specificata da condizione è falsa (cioè se non è vera). 
Se la condizione specificata è falsa, viene elaborata la specifica che segue la con- 
dizione. 


La porzione condizione dell'espressione IF deve essere una stringa continua di 
caratteri diversi dagli spazi vuoti. Uno spazio vuoto indica la fine della condizio- 
ne. Gli spazi vuoti tra gli apici sono ammessi, ad esempio ‘AB D'‘. Le condizioni 
che si possono specificare, sono presentate iniziando con la Condizione ACTIVE 
(Esecuzione di procedure). 


Una prova IF e IFT per espressioni condizionali multiple è vera quando viene 
soddisfatta una delle seguenti condizioni multiple. Per esempio: 


// IF ACTIVE-'PROC1,PROC2', PROC3 


La procedura PROC3 è eseguita se PROC1, PROC2 o sia PROC1 che PROC2 
sono in esecuzione sul sistema. 


Una prova IFF per espressioni condizionali multiple è falsa quando vengono sod- 
disfatte tutte le condizioni multiple. Per esempio: 


// IFF ACTIVE-'PROC1,PROC2' PROC3 


La procedura PROC3 viene eseguita se sia PROC1 che PROC2 non sono in esecu- 
zione sul sistema. 


La porzione specifica dell'espressione IF è descritta nella Porzione specifica del- 
l'espressione condizionale 1F. 


E' anche possibile usare un'espressione ELSE per eseguire una funzione quando 
l'espressione IF non è soddisfatta. Vedere le Espressioni ELSE. 
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Quando si usano certe espressioni condizionali. la condizione specificata può es- 
sere vera nel momento in cui la condizione viene verificata. In ogni caso, può 
non essere vera quando si cerca di elaborare qualcosa in un tempo successivo. 
L'elaborazione che viene eseguita sulla base dei risultati di un'espressione IF deve 
essere eseguita con cura in quanto la condizione che viene verificata potrebbe 
essere cambiata. 


Condizione ACTIVE (Esecuzione di procedure) 


L'espressione condizionale ACTIVE determina se una o più procedure sono in 
esecuzione sul sistema. ° 


Se la condizione è vera, almeno una delle procedure specificate era attiva al mo- 
mento in cui è stata effettuata la prova ACTIVE. L'elaborazione basata sulla pro- 
va ACTIVE dovrebbe essere eseguita con cautela in quanto la condizione che vie- 
ne verificata potrebbe essere cambiata. Se si cerca di provare la procedura che 
conteneva la prova ACTIVE, la prova sarà sempre falsa. La prova ACTIVE non 
può essere usata per determinare se si è l’ultimo utente di un MRT. 


IFT 
IFF 


'procl,proc2,...,procn' 


// (IF sai procedura } specifica 





nome procedura specifica il nome di una procedura. La condizione è vera se la 
procedura specificata è correntemente in esecuzione sul sistema. 


‘proc1,proc2...procn’ specifica due o più nomi di procedura. Per le prove IF e 


IFT la condizione è vera se una qualsiasi delle procedure specificate è cor- 
rentemente in esecuzione sul sistema. Per la prova IFF, la condizione è 
falsa se tutte le procedure specificate non sono in esecuzione sul sistema. 

specifica indica una specifica da elaborare. Vedere la Porzione specifica di una 
espressione condizionale IF per ulteriori informazioni. 


Esempio 1 


Questo esempio specifica che se una procedura chiamata PROC1 è attiva, il si- 
stema deve cancellare l'esecuzione della procedura che contiene la prova IF. 


// IF ACTIVE-PROCl CANCEL 


Esempio 2 


Questo esempio specifica che la procedura PAYROLL può essere eseguita soltan- 
to se entrambe le procedure PROC1 e PROC2 non sono attive. 


// IFF ACTIVE-'PROC1,PROC2' PAYROLL 
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Condizione BLOC KS (Spazio disponibile su disco) 


L'espressione condizionale BLOCKS determina se è disponibile lo spazio su disco 
specificato. Se la condizione è vera, il numero dei blocchi specificato era disponi- 
bile al momento in cui l’espressione BLOCKS era stata valutata. Se altri pro- 
grammi sono in esecuzione, uno di essi potrebbe usare quello spazio disponibile 
prima che il programma a cui BLOCKS si riferisce cerchi di farlo. 


// (IF BLOCKS-ampiezza specifica 


IFT 
IFF 





ampiezza specifica il numero dei blocchi e può essere un numero composto da 1 
a 8 cifre. Questa condizione è vera se è disponibile sul disco il numero spe- 
cificato di blocchi contingui {cioè di blocchi che sono riuniti in un solo 


posto). 


specifica indica una specifica da elaborare. Vedere la Porzione specifica di una 
espressione condizionale /F per ulteriori informazioni. 


Esempio 


Questo esempio specifica che se non sono disponibili 150 blocchi contigui su 
disco, il lavoro deve essere cancellato. 


// IFF BLOCKS-150 CANCEL 


Condizione CONSOLE (Console di sistema) 


L'espressione condizionale CONSOLE determina se la procedura è in esecuzione 
da parte della console di sistema. 


// (IF |) CONSOLE- { i specifica 


IFT NO 


IFF 





YES: è vero se la procedura viene correntemente eseguita dalla console di sistema. 
NO: è vero se la procedura non è correntemente eseguita dalla console di sistema. 


specifica indica una specifica da elaborare. Vedere la Porzione specifica di un'’e- 
spressione condizionale IF per ulteriori informazioni. 
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Esempio 


Questo esempio specifica che se la procedura non viene eseguita sulla console di 
sistema, il sistema deve cancellare l'esecuzione delia procedura. 


//.IF CONSOLE-NO CANCEL 


Condizione DATAF1 (File, librerie e cartelle su disco) 


L'espressione condizionale DATAF1 determina se il file, la libreria o la cartella spe- 
cificati esistono sul disco. Questa condizione è vera se esiste un file residente (T) o! 
se esiste una libreria o cartella sul disco con il nome e la data di creazione (opziona- 
le) specificati. Se è specificato ALL, la condizione è vera se il file, la libreria o la. 
cartella esistono sul disco che inizia con i caratteri del nome specificato. Questa 
prova non individua un file temporaneo (S) o di lavoro (J) col nome specificato. 


DATAF1- {| nome specifica 


‘nome ,data! 
‘nome, ALL' 





nome specifica il nome del file, della libreria o della cartella da ricercare. 


data specifica la data di creazione del file. La data è facoltativa. Se non viene 
specificata, viene assunto il file avente la data di creazione più recente. Se è 
specificata, deve essere nel formato della data della sessione. Se è specificato 
il nome di una libreria, la data non deve essere specificata. Se sono specifica- 
ti i nomi di una libreria e la data, viene segnalata una condizione falsa. 


ALL specifica che viene richiesto il disco per file, libreria o cartella che inizia con i 
caratteri del nome specificato. Se non vi sono file, librerie o cartelle che iniziano 
con i carateri dati, viene segnalata una condizione falsa. Se è specificato ALL, 
vengono scelti soltanto file, librerie e cartelle locali. Se non è specificato ALL, 
viene ricercato l’indirizzario della risorsa di rete. 


specifica indica una specifica da elaborare. Vedere la Porzione specifica di un’e- 
spressione condizionale IF per ulteriori informazioni, 


Esempio 


Questo esempio specifica che se non esiste un file su disco col nome specificato 
dal secondo parametro posizionale, la procedura BLDFILE deve essere eseguita 


per creare il file, 


// IFF DATAF1-?2? BLDFILE ?2?,S,BLOCKS,10,100 


96 


Condizione DATAI1 (File su minidisco) 


L'espressione condizionale DATAI1 determina se sul minidisco esiste il file speci- 
ficato. La condizione è vera se sul minidisco esiste un file con il nome e la data 
di creazione (facoltativa) specificata. Se il sistema dispone di un modulo a minidi- 
sco con un caricatore, il parametro dì locazione specifica la posizione del minidi- 
sco o dei minidischi su cui cercare. 


Per i moduli con caricatore: se il controllo viene effettuato su più di un alimenta- 
tore, la prova è interrotta quando viene trovato un accoppiamento; pertanto non 
tutti gii alimentatori potrebbero essere stati provati. Quando la condizione è vera 
per un modulo a minidischi con caricatore, il minidisco rimane nel lettore di mi- 
nidischi fino a che lo sportello del modulo non è aperto, non viene eseguita una 
procedura che usa il modulo a minidischi oppure non termina il passo di lavoro 
o il lavoro. 


DATAIl- | nome specifica 


‘nome sdata,locazione! 
'nome,, locazione! 





nome specifica il nome del file da cercare. 


data specifica la data di creazione del file. La data è facoltativa. Se la data non è 
specificata, la prova è vera quando si trova il primo file, 


locazione specifica la locazione del minidisco da controllare se il sistema dispone 
di un modulo a minidischi con caricatore. Può essere uno qualsiasi fra i se- 
guenti: 


$,1 S$2 o $3 identifica un singolo alimentatore a minidischi. Se non è specificata 
una locazione, viene presunto S1. 


ALLS, specifica che tutti gli alimentatori (S1, S2 e S3) devono essere esaminati. 
M1.nn identifica una locazione nell'ambito del caricatore 1. nn può essere qual. 
siasi numero da 01 a 10. Per esempio M1.04 indica la locazione 4 nell’ambi- 


to del caricatore 1. 


M2.nn identifica una locazione nell’ambito del caricatore 2, nn può essere qual- 
siasi numero da 01 a 10, i 


ALL1 specifica che bisogna cercare in tutti i minidischi nel caricatore 1. 
ALL2 specifica che bisogna cercare in tutti i minidischi nel caricatore 2. 
ALL specifica che bisogna cercare in tutti i minidischi in entrambi i caricatori. 


specifica indica una specifica da elaborare. Vedere la Porzione specifica di un'e- 
spressione condizionale IF per ulteriori informazioni. 
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// 


IF 
IFT 


“IFF 


Esempio 1 
Questo esempio specifica che se esiste un file con il nome FILEA sul minidisco 
nell’alimentatore 1, la procedura DELETE deve essere eseguita per cancellare quel 


file, 


// IF DATAIl-'FILEA,,Sl' DELETE FILEA,Il 


Esempio 2 
Questo esempio specifica che se non esiste un file denominato FILEB sul minidi- 
sco nel caricatore 1, locazione 5, deve essere eseguita la procedura SAVE per co- 


piare il file sul mindisco. 


// IFF DATAIl-'FILEB,,Ml1.05' SAVE FILEB,,,VOLOO1,M1.05 


Condizione DATAT (File su nastro) 
L'espressione condizionale DATAT determina se il file specificato esiste sul na- 
stro. La condizione è vera se esiste un file sull'unità nastro specificata con il no- 


me e della data'di creazione (facoltativa) specificati. 


Se il nastro non viene montato sull'unità specificata oppure se l’unità specificata 
non è in linea, viene inviato un messaggio di errore. 


a } specifica 


‘nome ,data,unità,fine! 





nome specifica il nome del file che deve essere cercato. 
data specifica la data di creazione del file. La data è facoltativa. Se la data non 


viene indicata, la prova è vera quando viene reperito il primo file con il no- 
me specificato. 


unità specifica l’unità mastro che deve essere controllata se il sistema ne ha più 
di una. Può essere una qualsiasi tra le seguenti: 


T1 controlla il nastro montato sull'unità 1. Se l’unità non è specificata, si 
presume T1. 


T2 controlla il nastro montato sull'unità 2. 


TC controlla il nastro sull'unità nastro a cassetta. 


fine specifica la posizione del nastro dopo che questo è stato cercato. Può essere 
una qualsiasi fra le seguenti: 


REWIND specifica che il mastro deve essere riavvolto all’inizio dopo essere 
stato cercato. Se la fine non è specificata, si presume REWIND. 


LEAVE specifica che il nastro deve rimanere nella posizione dove è stato 
trovato il file. 


UNLOAD specifica che il nastro deve essere riavvolto e scaricato per la rimo- 
| zione dopo essere stato cercato. Se è specificato TC, UNLOAD è invalido. 


specifica indica una specifica che deve essere elaborata. Per ulteriori informazioni, 
vedere la Porzione Specifica dell'Espressione Condizionale /F. 


Esempio 1 
Questo esempio specifica che se un file con if nome FILEA non esiste sull'unità 
nastro 1, deve essere eseguita la procedura SAVE per copiare il file fino alla fine 
del nastro. 


/] IFF DATAT-'FILEA,,T1,LEAVE' SAVE FILEA,,,VOLOO1,T1,,,33, LEAVE 


Esempio 2 
Questo esempio indica che se un file denominato FILEB non esiste sull'unità 
nastro 2, deve essere eseguita la procedura RESTORE per copiare il file da nastro 


su disco. 


// IF. DATAT-'FILEB,,T2,REWIND' RESTORE FILEB, 3,12 


Condizione DSPLY (Tipo unità video) 


L'espressione condizionale DSPLY determina il tipo di unità video che viene 
usata. 


/} (IF DSPLY- { 1920 specifica 


IFT 24x80 
IFF 27x132 





1920 è supportato per compatibilità con il Sistema/34 della IBM. Questa prova 
sarà sempre vera. 


24 x 80 è uguale a DSPLY - 1920. Significa che la procedura è eseguita su un 
terminale video che può visualizzare 24 linee e 80 caratteri per linea. Questa 
prova sarà sempre vera. 


27 x 132 è valido se la procedura è eseguita su un terminale video che può 
visualizzare 27 linee e 132 caratteri per linea. li terminale video 3180 modello 
2 può cambiare tra 27 linee e 132 caratteri e 24 linee e 80 caratteri. 


specifica indica una specifica da. elaborare. Per ulteriori informazioni vedere la 
Porzione Specifica dell’Espressione Condizionale 1F. 


Condizione ENABLED (Comunicazione abilitata) 


L'espressione condizionale ENABLED determina se il nome di configurazione 
Interactive Communications Feature (SSP-ICF) e il nome di locazione specificati 
sono abilitati. 


/] (IF ENABLED- | nome configurazione specifica 
IFT 'nome configurazione,! 


IFF ‘nome configurazione nome locazione! 
',nome locazione! 





nome configurazione o ‘nome configurazione," questa condizione è vera se è abili- 
tato il nome di configurazione specificato SSP-ICF. 


‘nome configurazione,nome locazione’ questa condizione è vera se il nome della 
configurazione SSP-ICF specificato e il nome della sua locazione sono abili- 
tati. 


‘nome locazione’ questa condizione è vera se è abilitato il nome della locazione 
SSP-ICF specificato. 


specifica indica una specifica da elaborare. Vedere per ulteriori informazioni la 
Porzione specifica dell'espressione condizionale /F, 
Esempio 1 
Questo esempio specifica che se non è abilitato il nome di configurazione SSP- 
ICF COMNAME, deve essere visualizzato il messaggio: Config name COMNAME 


not enabled. 


// TFF ENABLED-COMNAME * *'Config name COMNAME not enabled! 
oppure: 


// IFF ENABLED-'COMNAME,' * 'Config name COMNAME not enabled' 


Esempio 2 
Questo esempio specifica che se il nome di configurazione SSP-ICF COMNAME 
e il npme di locazione LOC1 non sono abilitati, deve essere visualizzato il mes- 


saggio: Communications not enabled. 


// IFF ENABLED-'COMNAME,LOC1' * ‘Communications not enabled! 


Esempio 3 


Questo esempio specifica che se il nome di locazione SSP-ICF LOCI è abilitato, 
deve essere visualizzato il messaggio: Communications enabled. 


// IF ENABLED-',LOC1!' * 'Communications enabled' 
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Condizione EVOKED (Procedure richiamate) 


L'espressione condizionale EVOKED determina se una procedura è stata avviata 
Da da un'operazione di richiamo Interactive Communications Feature (SSP-ICF) o da 
una specifica OCL EVOKE. 


IFT 
IFF 


NO 


// (IF RU) specifica 





YES: è vero se la procedura è stata richiamata attraverso il SSP-ICF o dalla speci- 
fica OCL EVOKE. 


NO: è vero se la procedura non è stata richiamata attraverso il SSP-ICF o dalla 
specifica OCL EVOKE, 


specifica indica una specifica da elaborare. Vedere per ulteriori informazioni la 
Porzione specifica dell'espressione condizionale IF. 


Esempio 1 


Questo esempio indica che se Ja procedura contenente questa specifica è stata ri- 
chiamata da una specifica OCL EVOKE, viene inviato il messaggio Procedure 
Running all'unità video che ha effettuato l'operazione di richiamo. 


Li // IF EVOKED-YES MSG ?WS?,Procedure running 


Esempio 2 
Questo esempio indica che se la procedura contenente questa specifica non è 


stata richiamata dalla specifica OCL EVOKE e non è in esecuzione dalla coda dei 
lavori, verrà visualizzato il messaggio Procedure Running sull’unità video. 


// IF JOBQ-NO IF EVOKED-NO * 'Procedure running! 
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Condizione INQUIRY (Modo interrogazione) 


L'espressione condizionale INQUIRY determina se una procedura viene eseguita 
nel modo operativo di interrogazione. Cioè se l'operatore ha usato il tasto Atten 2 
(attenzione) per interrompere un programma per eseguire questa procedura. 


// ( IF sii specifica 


IFT NO 


IFF 





YES: è vero se la procedura contenente l’espressione viene eseguita nel modo 
operativo di interrogazione. 


NO: è vero se la procedura non viene eseguita nel modo operativo di interroga- 
zione. 


specifica indica una specifica da elaborare, Vedere per ulteriori informazioni la 
Porzione specifica dell'espressione condizionale IF. 


Esempio 


Questo esempio indica che se la procedura contenente queste istruzioni viene ese- 
guita nel modo operativo di interrogazione, la procedura deve essere cancellata. 


// IF INQUIRY-YES CANCEL 


ni 
Condizione JOBOQ (Coda lavori) 


L'espressione condizionale JOBO determina se viene eseguita una procedura dalla 
coda di lavori. 


// { IF i specifica 


IFT 
IFF 


NO 





YES: è vero se la procedura viene eseguita dalla coda lavori. 
NO: è vero se la procedura non viene eseguita dalla coda lavori. 


specifica indica una specifica da elaborare. Vedere per ulteriori informazioni la 
Porzione specifica dell'espressione condizionale IF. 
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Esempio 1 


Questo esempio indica che se la procedura contenente la specifica viene eseguita 
da dalla coda dei lavori, verrà inviato il messaggio Procedure Running all'unità video 
che ha inserito il lavoro nella coda lavori. 


/] IF JOBQ-YES MSG ?WS?,'Procedure running! 


Esempio 2 


Questo esempio indica che se la procedura contenente questa specifica non viene 
eseguita dalla coda lavori, viene visualizzato il messaggio Procedure Running. 


// IF JOBQ-NO * 'Procedure running! 


Condizione LISTDONE (Completamento elenco telefonico) 


L'espressione condizionale LYSTDONE determina se tutti i numeri di un elenco 
di numeri telefonici sono stati chiamati. Questa condizione è vera se ogni numero 
dell'elenco telefonico specificato è stato chiamato con successo o se per quei 
numeri non chiamati con successo, è stato esaurito il conteggio dei tentativi ri- 
petuti. 


LISTDONE-nome membro specifica 


nome membro specifica il nome di un elenco telefonico creato dalla procedura 
DEFINEPN o DEFINX21. 


specifica indica una specifica da elaborare. Vedere per ulteriori informazioni la 
Porzione specifica dell'espressione condizionale IF. 


Esempio 


In questo esempio il programma CALLPROG si ripete ogni volta chiamando il 
successivo numero della lista. Quando è stato chiamato l’ultimo numero oppure 
se sono stati esauriti i conteggi dei tentativi a seguito di errore, l’espressione |F 
sarà vera e la procedura termina. 


// TAG START 

// LOAD CALLPROG 

// COMM LINE-1,PHONE-LISTI 

// RUN 

// IFF LISTDONE-LISTI GOTO START 
// * 'Program CALLPROG completed! 
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Condizione LOAD (Membro oggetto di libreria) 


L'espressione condizionale LOAD determina se esiste un membro oggetto di li- 
breria in una libreria specificata. La condizione è vera se nella libreria specificata . 


esiste il membro oggetto specificato. 


} specifica 


// { IF LOAD- { nome membro 
IFT 'nome membro,nome libreria! 


IFF 





nome membro specifica il nome del membro oggetto di libreria da cercare. 

nome libreria specifica il nome della libreria in cui cercare il membro oggetto. 
Se non viene specificato alcun nome di libreria, si presume la libreria di si- 
stema (#LIBRARY). 


specifica indica una specifica da elaborare. Vedere per ulteriori informazioni la 
Porzione specifica dell'espressione condizionale IF. 


Esempio 


Questo esempio specifica che se nella libreria corrente (indicata da?CLIB?) esiste 
un membro oggetto denominato PROGI1, la procedura REMOVE deve essere ese- 


guita per rimuovere quel membro. 


/] IF LOAD-'PROG1,?CLIB?' REMOVE PROG1,LOAD,?CLIB? 


Condizione MRTMAX (Terminali richiedenti multipli) 


L'espressione condizionale MRTMAX determina se una procedura per terminali 
richiedenti multipli (MRT), ha il numero massimo di terminali richiedenti. La 
condizione è vera se la procedura MRT specificata ha il massimo numero di ri- 


chiedenti collegati. 


MRIMAX-nome procedura specifica 








nome procedura specifica il nome di una procedura MRT. 


specifica indica una specifica da elaborare. Vedere per ulteriori informazioni la 
Porzione specifica dell'espressione condizionale IF. 


pens 


Esempio 


Questo esempio specifica che se la procedura ORDERS ha il numero massimo di 
utenti collegati, devono essere visualizzati due messaggi e devono essere elaborate 
una specifica PAUSE e una specifica CANCEL. 


// IFF MRTMAX-ORDERS GOTO START 

// * 'Too many people are using the ordering procedure 
// * 'Canceling procedure; Try again later' 

// PAUSE 

// CANCEL 

// TAG START 

ORDERS 


Condizione PROC (Membri di procedura di libreria) 


L'espressione condizionale PROC determina se in una libreria specificata esiste un 
membro di procedura di libreria. La condizione è vera se il membro di procedura 
esiste nella libreria specificata. 


IFT 
IFF 


‘nome membro,nome libreria! 


// {IF sai nome membro } specifica 





nome membro specifica il nome del membro di procedura di libreria da cercare. 

nome libreria specifica il nome della libreria in cuì cercare il membro di procedu- 
ra. Se non viene specificato alcun nome di libreria, si presume la libreria di 
sistema (#LIBRARY). 

specifica indica una specifica da elaborare. Vedere per ulteriori informazioni la 
Porzione specifica dell'espressione condizionale IF, 

Esempio 
Questo esempio indica che se nella libreria corrente (indicata da?CL1IB?) esiste 


un membro di procedura denominato TEST, deve essere eseguita la procedura 
REMOVE per rimuovere quel membro. 


// IF PROC-'TEST,?CLIB?' REMOVE TEST,PROC,?CLIB? 
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Condizione SECURITY (Riservatezza con parola d’ordine) 
L'espressione condizionale SECURITY determina quanto segue: 
e Se sul sistema è attiva la riservatezza mediante parola d'ordine. 


e La classificazione di riservatezza dell'operatore. 


// { IF SECURITY-| ACTIVE specifica 
IFT 
IFF 





ACTIVE è vero se sul sistema è attiva la riservatezza mediante parola d'ordine, 

M, S, O, C, e D specificano livelli di riservatezza. La condizione è vera se la clas- 
sificazione di riservatezza dell'operatore è uguale o supera la classificazione 
di riservatezza specificata. Se non è attiva la riservatezza mediante parola 
d’ordine, tutte queste prove saranno vere. 
M Responsabile principale della riservatezza 
S Responsabile della riservatezza 
O Operatore di sistema 
C Operatore di sotto-console 
D Operatore di unità video 

specifica indica una specifica da elaborare. Vedere per ulteriori informazioni la 
Porzione specifica dell'espressione condizionale IF. 

Esempio 1 


Questo esempio indica che se non è attiva la riservatezza mediante parola d’ordi- 
ne, il messaggio deve essere inviato alla console di sistema. 


// IFF SECURITY-ACTIVE ** 'PROCEDURE ?PROC? BEING RUN BY ?USER?' 


Esempio 2 


Questo esempio .indica che questa procedura può essere eseguita soltanto, se 
l'operatore ha un livello di riservatezza di operatore di sistema, di responsabile 
della riservatezza o di responsabile principale della riservatezza. Se l'operatore ha 
un livello di riservatezza di operatore di sotto-console o di operatore di unità 
video, la procedura viene cancellata. Se non è attiva la riservatezza mediante 
parola d'ordine, la procedura deve essere eseguita dalla console di sistema. 


// IFF SECURITY-O CANCEL 


// ELSE IFF SECURITY-ACTIVE IF CONSOLE-NO CANCEL 
// LOAD PROGRAMI 
// RUN 
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Condizioni SOURCE (Membri origine di libreria) 


L'espressione condizionata SOURCE determina se nella libreria specificata esiste 
un membro origine di libreria. La condizione è vera se il membro origine. specifi 
cato esiste nella libreria specificata. 


// { IF aa membro } specifica 


IFT 'nome membro nome libreria! 


IFF 





nome membro specifica il nome del membro origine di libreria da cercare. 


nome libreria specifica il nome della libreria in cui cercare il membro origine. Se 
non viene specificato alcun nome di libreria, si presume per difetto la libre- 
ria di sistema (#LIBRARY). 


specifica indica una specifica da elaborare. Vedere per ulteriori informazioni la 
Porzione specifica dell'espressione condizionale IF. 


Esempio 


Questo esempio specifica che se nella libreria corrente (indicata da ?CLIB?) non 
esiste un membro origine denominato FORMATS, deve essere eseguita la proce- 
dura SDA per creare quel membro. 


// IFF SOURCE-'FORMATS,?CLIB?' SDA FORMATS,?CLIB? 
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Condizione SUBR (Membri di sottoroutine di libreria) 


L'espressione condizionale SUBR determina se esiste un membro di sottoroutine 
di libreria in una libreria specificata. La condizione è vera se nella libreria specifi- 
cata esiste il membro di sottoroutine. 


// | IF e membro } specifica 


IFT ‘nome membro ,nome libreria' 


IFF 





nome membro specifica il nome del membro di sottoroutine di libreria da cercare. 

nome libreria specifica il nome della libreria in cui cercare il membro di sottorou- 
tine. Se non viene specificato alcun nome di libreria, viene assunta per difet- 
to la libreria di sistema (#LIBRARY). 


specifica indica una specifica da elaborare. Vedere per ulteriori informazioni la 
Porzione specifica dell'espressione condizionale |F, 
Esempio 
Questo esempio specifica che se nella libreria corrente (indicata da ?CLIB?) esiste 
un membro origine denominato PROG1, deve essere eseguita la procedura 


REMOVE per rimuovere quel membro. 


// IF SUBR-'PROG1,?CLIB?' REMOVE PROG1,SUBR,?CLIB? 
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Condizione SWITCH (Interruttori) 


L'espressione condizionale SWITCH determina le regolazioni degli interruttori in- 
dicatori di stato del programma utente (USPI). La condizione è vera se tutti gli 
8 interruttori per l'unità video sono nello stato specificato. 


/} { IF SWITCH-impostazione indicatori specifica 


IFT 
IFF 





impostazione indicatori si compone di 8 caratteri uno per ciascuno degli 8 indica- 
tori (da 1.a 8). Per ciascuna delle 8 posizioni nei valore dell’impostazione 
degli indicatori esterni, deve essere usato uno dei seguenti caratteri: 


0 Zero indica che il corrispondente indicatore deve essere disattivato per- 
chè la condizione sia vera. 


1. Uno indica che il corrispondente indicatore deve essere attivato perchè 
la condizione sia vera. 


X Indica che il corrispondente indicatore non è controllato. 
specifica indica una specifica da elaborare. Vedere per ulteriori informazioni la 
Porzione specifica dell'espressione condizionale IF. 
Esempio 
Questo esempio specifica che se gli interruttori 1 e 2 sono attivati e se l'interrut- 


tore 3 è disattivato (gli altri interruttori non sono controllati), deve essere esegui- 
ta la procedura denominata MASTER, 


// IF SWITCH-110XXXXX MASTER 
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// 


IF 
IFT 
IFF 


Condizione SWITCHn (Singoli interruttori) 


L'espressione condizionale SWITCHn determina la regolazione dell’n-esimo inter- 
ruttore. 


Là } specifica 


i 





nm è un numero da1a8 che indica quale interruttore deve essere provato. 
O Zero. La condizione è vera se l’n-esimo interruttore è disattivato. 
1. Uno. La condizione è vera se l’n-esimo interruttore è attivato. - 
specifica indica una specifica da elaborare. Vedere per ulteriori informazioni la 
Porzione specifica dell'espressione condizionale 1F. 
Esempio 
Questo esempio indica che se l'indicatore 2 è disattivato, deve essere attivato. 


/} IF:SWITCH2-0 SWITCH X1XXXXXX 


IF 
IFT 
IFF 


Condizione stringa = stringa? (Confronto, uguale a) 


L'espressione condizionale = determina se un'espressione è uguale ad un'altra 
espressione. Questa condizione è vera se stringa1 è uguale a stringa2. 


stringal=stringa2 specifica 
stringal/stringa? 





stringal e stringa2 rappresentano due valori, ad esempio parametri, dati alfabetici 
o espressioni di sostituzione. Ciascuna stringa può contenere fino a 128 ca- 
ratteri. Se la stringa contiene spazi in bianco, segni di uguale (=), barrette 
{/), segni di maggiore di (>) o trattini di divisione sillabica (—), la stringa 
deve essere racchiusa tra apici ("). Se la stringa contiene un apice, ad esempio 
l'orologio, occorre immettere due apici; ad esempio: ‘l'orologio’. 


specifica indica una specifica da elaborare. Vedere per ulteriori informazioni la 
Porzione specifica dell'espressione condizionale IF. 


Se uno o l’altro dei due valori che vengono confrontati contiene qualsiasi caratte- 
re alfabetico o è racchiuso tra apici (‘), le due stringhe sono riempite sulla destra 
con spazi in bianco fino ad una lunghezza di 128 e il confronto avviene su base 


carattere per carattere, iniziando col carattere più a sinistra. 


Se entrambi i valori che vengono confrontati hanno soltanto caratteri numerici 
(e non. sono racchiusi tra apici), le due stringhe sono completate sulla sinistra 
con degli zeri decimali fino ad una tunghezza di 128 e il confronto avviene su 
base carattere per carattere, iniziando con il carattere più a sinistra. Le cifre nu- 
meriche precedute da un segno + o — sono considerate stringhe numeriche. 


Per esempio, 


// IF ABCD='ABC *' PROCA 
// IF 1331 PROCB 


risulterebbe come: 


ABCD: ABCD 

ABC: ABC 

13: 000. ..0013 
DE 000...0001 


. Indica altri zeri. 


1 dati numerici possono essere positivi o negativi ad esempio +25 o —-3. Il segno 
+ non è necessario: per esempio 25 si presume che sia + 25. Il valore — 0 è trat- 
tato come 0. | dati alfanumerici preceduti da un segno, devono essere racchiusi 
tra apici, ad esempio: ‘#ABCDE’. Se il primo carattere di una stringa è un + o 
un —, tutti ì rimanenti caratteri nella stringa, devono essere numerici. Se compare 
un segno in una stringa in qualsiasi posizione tranne la prima, è considerato un 
dato. 
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Sono indicati qui di seguito esempi del modo in cui è possibile specificare le 
stringhe: 


stringal=stringa2? 
‘stringal'=stringa2 


'stringal'='stringa2' 


Esempio 1 


Questo esempio indica che se il terzo parametro posizionale è PAYROLL, deve 
essere eseguita la procedura denominata PAYROLL. 


// IF ?3?=PAYROLL PAYROLL 


Esempio 2 


Questo esempio indica che se il primo parametro posizionale non ha un valore, 
deve essere elaborata ia specifica OCL PROMPT. 


// IF ?1?/ PROMPT MEMBER-SCREENS,FORMAT-F1 


Condizione stringa1 > stringa2 (confronto, maggiore di) 


L'espressione condizionale > determina se un'espressione è maggiore di un'altra. 
Questa condizione è vera se stringa] è maggiore di stringa2. 


// {IF |} stringal>stringa2 specifica 


IFT 
IFF 





stringal e stringa2 rappresentano due valori, ad esempio parametri, dati alfanu- 
merici o espressioni di sostituzione. Ciascuna stringa può essere lunga fino a 
128 caratteri. Se la stringa contiene spazi vuoti, segni di uguale (=), barrette 
(/), segni di maggiore di (>) o trattini di divisione sillabica (—), la stringa 
deve essere racchiusa tra apici (‘), Per informazioni sul modo in cui le strin- 
ghe sono confrontate e sul modo in cui possono essere immesse, vedere 
Condizione stringa] = stringa2 (Confronto, uguale a). 


specifica indica una specifica da elaborare. Vedere per ulteriori informazioni la 
Porzione specifica dell'espressione condizionale IF. 
Esempio 


Se il valore del quarto parametro posizionale è maggiore di 100, deve essere ese- 
guita fa procedura denominata MASTER. 


‘// IF ?4?>100 MASTER 


Condizione VOLID {ID Volume Minidisco e Nastro) 


L'espressione condizionale VOLID determina se viene usato il minidisco o il na- 
stro corretto. Questa condizione è vera se ID di volume del minidisco o del na- 
stro indicato è identico all'ID di volume specificato. Per i moduli a caricatore: se 
viene controllato più di un alimentatore, la prova viene interrotta quando sì trova 
una corrispondenza; pertanto non possono essere provati tutti gli alimentatori. 


Se il modulo a minidischi o la locazione specificata sono vuoti o l’unità nastro è 
vuota, viene visualizzato un messaggio. L'operatore può quindi inserire un minidi- 
sco o un nastro nella locazione specificata oppure cancellare il lavoro. 


IFT 'id volume, locazione! 


IFF 


// (IF ia volume } specifica 





ID volume specifica l'ID di volume da cercare. 

locazione specifica la locazione del minidisco o del nastro da controllare se il siste- 
ma dispone di un modulo a minidischi a caricatore o di un’unità nastro. Su un 
sistema senza caricatore, una qualsiasi locazione di minidisco si risolve in S1. 
Può essere una qualsiasi tra è seguenti: 


S1, $2, o S$3 identifica un singolo alimentatore a minidischi. Se non è speci- 
ficata una locazione, si presume S1, 


ALLS specifica che si deve cercare in tutti gli alimentatori (S1, S2 e S3). 
M1.nn identifica una locazione nell'ambito del caricatore 1. nn può essere 
qualsiasi numero da 01 a 10. Per esempio M1.04 indica la locazione 4 


nell'ambito dei caricatore 1. 


M2.nn identifica una locazione nell'ambito del caricatore 2, nn può essere 
qualsiasi numero da 01 a 10. 


ALL1 specifica che si deve cercare in tutti i minidischi nel caricatore 1. 
ALL2 specifica che si deve cercare in tutti i minidischi ne! caricatore 2. 

ALL specifica che si deve cercare in tutti i minidischi in entrambi i caricatori. 
T1 specifica che deve essere cercato il nastro nell'unità nastro 1. 


T2 specifica che deve essere cercato il nastro nell'unità nastro 2. 


TC specifica che deve essere cercato il nastro nell'unità nastro a cassetta. 


specifica indica una specifica da elaborare. Vedere per ulteriori informazioni la 
Porzione specifica dell'espressione condizionale /F. 
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Esempio 1 


Questo esempio indica che se l'ID di volume dei minidisco inserito non è VOL001, 
deve essere visualizzato il messaggio Insert correct diskette in slot 1. 


// IFF VOLID-VOLOOl PAUSE 'Insert correct diskette in slot l' 


Esempio 2 


Questo esempio specifica che se l'ID di volume del minidisco nella locazione 
M2.03 è TEST, le informazioni sul minidisco devono essere rimosse. 


// IF VOLID-'TEST,M2.03' INIT TEST,,DELETE,M2.03 


Esempio 3 


Questo esempio specifica che se l'ID di volume del nastro montato sull'unità na- 
stro 1 è TEST, le informazioni sul nastro devono essere rimosse. 


// IF VOLID-'TEST,T1' TAPEINIT TI sSTDLABEL,TEST,, ERASE 


Porzione specifica dell'espressione condizionale IF 


La porzione specifica in un'espressione condizionale IF può essere una fra le 
seguenti: 


e Una specifica OCL senza i caratteri // che normalmente precedono una speci- 
fica OCL. ” 


e Una specifica che può richiamare un’altra procedura. 


e Una specifica di controllo di programma di utilità senza i caratteri // che 
normalmente introducono una specifica di controllo di programma di utilità. 


e Un'altra espressione IF, IFT o IFF senza i caratteri // che normalmente pre- 
cedono l’espressione. Per esempio: 


// IF PROC-PAYROLL IF SWITCH3-1 PAYROLL 


specifica che se nella libreria di sistema c'è un membro di procedura denomi- 
nato PAYROLL e se l'indicatore 3 è attivato, deve essere eseguita la proce- 
dura PAYROLL. 


e Una specifica //*, //**, CANCEL, EVALUATE, GOTO, PAUSE, RESET o 
RETURN senza i caratteri // che normalmente precedeono la specifica. 


// ELSE 


Espressioni ELSE 


L'espressione ELSE è facoltativa e può essere usata soltanto con l’espressione IF. 
Usare ELSE quando si vuole elaborare una specifica in quanto un‘espressione IF 
non è stata soddisfatta. L'espressione ELSE è elaborata soltanto quando una o 
più espressioni IF che precedono ELSE non sono soddisfatte. L'espressione 
ELSE può essere usata con tutte le forme dell'espressione IF (IF, IFT e IFF). 


L'espressione ELSE ha il seguente formato: 


specifica 





specifica può essere qualsiasi specifica valida per l'espressione condizionale |F; 
vedere la Porzione specifica di un'espressione condizionale 1F. 


Esempio di espressioni IF e ELSE: 


// IF ?19= RETURN 
// ELSE DELETE ?1? 


In questo esempio: 


e Se il primo parametro della procedura non viene immesso, viene elaborata la 
specifica RETURN. 


e Se viene immesso il primo parametro sulla procedura (il parametro 1 non è 
uno spazio vuoto), deve essere eseguita la procedura DELETE per cancellare 
il file specificato dal primo parametro. 


Può esserci soltanto un'espressione ELSE dopo l’espressione IF e deve essere in 

‘ ogni caso la prima espressione della riga. Se ELSE non segue immediatamente 
l'espressione IF, viene ignorata. Un'espressione IF può seguire un'espressione 
ELSE in una specifica condizionale. Per esempio: 


// IF ?2?= PAYROLL DAILY 
// ELSE IF ?2?=YEAREND PAYROLL YEAREND 
// ELSE PAYROLI, WEEKLY 
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In questo esempio, se il secondo parametro è uno spazio in bianco, viene richia- 
mata la procedura PAYROLL con il parametro DAILY. Se il secondo parametro 
è YEAREND, è passato a PAYROLL e viene eseguita la procedura PAYROLL. 
Se il secondo parametro non è nè uno spazio in bianco nè YEAREND, viene pas- 
sato il parametro WEEKLY a PAYROLL e PAYROLL viene eseguito. 


E’ ‘inoltre possibile avere espressioni condizionali in cui più di un'espressione IF 
{sulla stessa riga) compare prima di un'espressione ELSE, come in quanto segue: 


// IF SWITCHI-1 IF SWITCH2-1 PROCA 
// ELSE PROCB 


In questo caso verrà eseguita soltanto la procedura PROCA quando entrambi gli 
interruttori 1 e 2 sono attivati. Se uno o l’altro degli interruttori 1 o 2 è disat- 
tivato (e cioè se una o l’altra delle prove è falsa), viene eseguita la procedura 
PROCB. 


La continuazione di una specifica che segue un'espressione ELSE su due o più 
righe, rende l’espressione di continuazione errata. Per esempio: 


// IF SWITCHI-1 PROCA 
o; ELSE FILE NAME-WORK, 
/1 UNIT-F1 


si traduce in un errore quando l'interruttore 1 è attivato, in quanto il sistema 
elabora le due specifiche: 


// PROCA 
LI UNIT-F1 


il che provoca un errore. 


i ll { 


SPECIFICA //* (MESSAGGIO INFORMATIVO) 


La specifica //* fa sì che venga visualizzato un messaggio informativo sull'unità 
video che ha presentato il lavoro, a meno che la specifica //* non si trovi in un 
lavoro eseguito dalla coda di lavori o in un lavoro che ha rilasciato la sua unità 
video richiedente. in quei casi, la specifica //* provoca la comparsa di un messag- 
gio sulla console di sistema. 


Questo tipo di messaggio non è visualizzato se era stato precedentemente immes- 
so INFOMSG NO. Vedere per ulteriori informazioni il Comando di controllo 
INFOMSG. 


codice id. messaggio 
'testo messaggio! 





codice id messaggio (mic) specifica il codice di identificazione messaggi di quattro 
cifre di un messaggio nel membro messaggi corrente di primo livello. Viene 
visualizzato il testo del numero di messaggio specificato. Vedere la Specifica 
OCL MEMBER per informazioni sull'assegnazione del membro di messaggi di 
primo livello. Per informazioni sulla creazione di membri di messaggi, vedere 
la Procedura CREATE, 


‘testo messaggio’ specifica il testo del messaggio da visualizzare. ll testo del mes- 
saggio deve essere racchiuso tra apici (‘). E' possibile usare qualsiasi carattere 
nel testo di messaggio. Se il messaggio contiene apici incorporati (ad esempio 
in l'orologio), occorre immettere ciascun apice incorporato sotto forma di 
due apici {ad esempio: l'orologio). 


Il testo di messaggio può contenere un massimo di 505 caratteri. L'intero 
messaggio viene visualizzato 75 caratteri alla volta. Il messaggio viene listato 
75 caratteri alla volta nel file cronologico. 
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Esempio 1 


4 


Nell'esempio seguente il messaggio indica che è in corso la procedura PAYROLL, 


// * *'PAYROLL Procedure Running! 
// LOAD PAYROLL 
// RUN 


Esempio 2 


Nell'esempio che segue il messaggio indica che è in corso la procedura PAYROLL; 
in ogni caso il messaggio viene visualizzato soltanto quando la procedura viene 
eseguita da tastiera. 


// IF JOBQ-NO IF EVOKED-NO * 'PAYROLL Procedure Running! 
// LOAD PAYROLL, 
// RUN 


Esempio 3 


Nell'esempio che segue il messaggio indicato dal numero 0005 è visualizzato dal 
membro di messaggio di primo livello denominato MESSAGES, 


// MEMBER USFRl-MESSAGES,LIBRARY-MYLIB 
// * 0005 

// LOAD PAYROLL 

// RUN 


SPECIFICA //** (MESSAGGIO CONSOLE DI SISTEMA) 


/1 *x* { 





Esempio 


La specifica //* fa sì che venga visualizzato un messaggio sullo schermo di conso- 
le della console di sistema. Il lavoro interrompe l'elaborazione fino a che l’opera- 
tore di sistema non risponde al messaggio. Îl messaggio è visualizzato con un'op- 
zione di risposta 0. 


Se la procedura contenente la specifica //** viene eseguita dall'unità video asse- 


gnata come console di sistema, il messaggio viene visualizzato sul video comandi 
anzichè sullo schermo di console. 


codice id messaggio 
'testo messaggio '! 


codice id messaggio (mic) specifica il codice di identificazione messaggi di quattro 


cifre di un messaggio nel membro messaggi corrente di primo livello, Il testo 
del messaggio specificato viene visualizzato. Vedere la Specifica OCL 
MEMBER per informazioni sull’assegnazione del membro messaggi di primo 
livello. Per informazioni sulla creazione di membri di messaggi, vedere la 
Procedura CREATE. ù 


‘testo messaggio’ specifica il testo del messaggio da visualizzare, Il testo del mes- 


saggio deve essere racchiuso tra apici (‘). Qualsiasi carattere può essere usato 
nel testo di messaggio. Se il messaggio contiene apici incorporati (ad esempio 
come in l'orologio, occorre immettere ciascun apice incorporato sotto forma 
di due apici (ad esempio: l‘‘orologio). 


Il testo di messaggio può essere lungo fino a 504 caratteri. L'intero messag- 
gio viene visualizzato 75 caratteri alla volta, con ciascun messaggio si ha una 
risposta di opzione OD. |l messaggio è listato a 75 caratteri alla volta nel file 
storico, cronologico. 


Per far sì che sul video della console di sistema compaia il messaggio insert the 
next diskette, la-procedura può contenere: 


SAVE FILE1l,,,VOLOOl 
// *% ‘Insert the next diskette' 


SAVE FILE2,,,VOLOO2 
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SPECIFICA CANCEL 
La specifica CANCEL cancella la procedura e riporta il controllo alla tastiera per 
la successiva specifica. Se viene usata una specifica CANCEL per cancellare una 


procedura MRT, viene emesso un messaggio di errore a tutti i richiedenti attivi 
di quella procedura. i 


// CANCEL 


Esempio 


Questo esempio mostra la specifica CANCEL che viene usata per cancellare una 
procedura se un'espressione IF non è soddisfatta: 


// IFF DATAF1-FILEA CANCEL 
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SPECIFICA EVALUATE 
La specifica EVALUATE consente di fare quanto segue: 
e Assegnare valori ad un parametro 
e Eseguire somme, sottrazione, moltiplicazioni e divisioni 
e Valutare espressioni di sostituzione 
e Impostare il codice di ritorno 
E’ possibile valutare più di un'opzione alla volta. 


La specifica EVALUATE può contenere qualsiasi tipo di dati. Essa può contenere 
espressioni aritmetiche, espressioni di sostituzione o commenti. 


E’ possibile usare la specifica EVALUATE come risultato di una serie di prove 
condizionali. Ciò consente di seguire meglio le condizioni. Per esempio: 


// IF DATAFI-FILEA IF SWITCHI-1 EVALUATE (EVERYTHING IS FINE) 
tr ELSE CANCEL 
PROCA 


Se le prove sono vere, le specifiche EVALUATE e PROCA vengono elaborate; al- 
trimenti, viene elaborata la specifica CANCEL. Notare ii commento EVERYTH- 
ING IS FINE sulla specifica EVALUATE. Tutto ciò che non è riconosciuto come 
espressione è considerato un commento. 


Assegnazione di valori 


E’ possibile assegnare più di un parametro con la specifica EVALUATE ma cia- 
scun parametro che viene assegnato deve essere separato da uno o più spazi in - 
bianco. Le espressioni sono valutate da sinistra a destra. | risultati di un’espres- 
sione possono essere usati nell'espressione seguente. 


// EVALUATE Pn [,runghezza | =espressione 





P indica che è assegnato un parametro 


n indica il numero deli parametro di procedura (da 1 a 64) nel quale l’espres- 
sione è salvata. n può essere un numero o un'espressione di sostituzione con 


.un valore numerico. 


lunghezza è un valore facoltativo che specifica la lunghezza (numero di caratteri) 
dell'espressione risultante. La lunghezza può essere un numero da 1 a 15. 
Se la lunghezza non è specificata, viene usata la lunghezza dell'espressione; 
gli zeri non significativi non sono usati nel risultato finale. La lunghezza 
può essere specificata soltanto per i valori numerici. Se viene specificata una 
lunghezza e il numero di cifre significative nel risultato è maggiore della lun- 
ghezza specificata, il risultato è troncato a sinistra. Per esempio: 


-P3,2=123h5 


fa sì che il parametro 3 venga impostato a ‘45’. 
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Se viene specificata una lunghezza e il numero di cifre non significative nel 
risultato è più piccolo della lunghezza specificata, il risultato viene completa- 
to sulla sinistra con zeri. Per esempio: 


P3,5=123 
fa sì che il parametro 3 venga impostato a ‘00123’. 


Se non viene specificata alcuna lunghezza, viene usata la lunghezza dell’espres- 
sione. Per esempio: 


P3=876253 
fa sì che il parametro 3 venga impostato a ‘876253. 


Per i numeri negativi, deve essere riservato un posto per il segno meno (—). 
Per esempio: 


//] EVALUATE P5,2=-12-1 


il parametro 5 conterrà 13 invece di —13 in quanto non è stato lasciato spa- 
zio per il segno meno. 


espressione indica un'espressione. L'espressione può essere una costante intera, 
un'espressione di sostituzione avente il valore di un intero, una espressione di 
sostituzione avente il valore di una specifica in un membro di messaggio o una 
stringa di caratteri. Se la stringa di caratteri contiene spazi in bianco incorpora- 
ti, deve essere racchiusa tra apici (’); per esempio, P5=’ab c’. Per disattivare 
un parametro, immettere due apici consecutivi (’’), per esempio: P5="". 


Esempio 1 


Questo esempio assegna il valore 123 al parametro 1, il valore 456 al parametro 
2 e disattiva il parametro 3. | parametri 1 e 2 hanno una lunghezza di 3; il para- 
metro 3 ha una lunghezza di 0. 


// EVALUATE P1=123 P2=00h56 P3='! 


Esempio 2 


Questo esempio assegna il valore 00123 al parametro 1. Il parametro 1 ha una 
lunghezza di 5. 


// EVALUATE P1,5=123 


Esempio 3 


Questo esempio assegna il valore ‘EXAMPLE DATA' al parametro 1. Il parame- 
tro 1 ha una lunghezza di 12. 


// EVALUATE P1='EXAMPLE DATA! 


Esempio 4 


Se l'operatore ha come ID utente MAT, questo esempio assegna il valore MAT al 
parametro 1. ll parametro 1 ha una lunghezza di 3. 


// EVALUATE Pl=?USER? 


Esempio 5 
Se il parametro 3 ha un valore di 123, il parametro 9 ha un valore di 30 e il 
parametro 10 ha un valore di 5, questo esempio assegna un valore 00123 al 
parametro 30. }H parametro 30 ha una lunghezza di 5. 
// EVALUATE P?9?,2102=?3? 


verrebbe valutato come: 


// EVALUATE P30,5=123 


Somma, sottrazione, moltiplicazione o divisione 


E’ possibile assegnare più di un parametro sulla specifica EVALUATE ma ciascun 
parametro assegnato deve essere separato da uno o più spazi in bianco. | parame- 
tri che vengono assegnati sono valutati da sinistra a destra. 


// EVALUATE Pn [\3unghezze] =ESPRESSIONE 





P. indicache è assegnato un parametro 


n indica il numero dei parametro di procedura {da 1 a 64) nel quale 
l'espressione è salvata. n può essere un numero o un'espressione di 
sostituzione con un valore numerico. 


lunghezza è un valore facoltativo che specifica la lunghezza (numero di caratteri) 
dell'espressione risultante. La lunghezza può essere un numero da 1 a 15. Se 
la lunghezza non è specificata, viene usata la lunghezza dell'espressione; gli 
zeri non significativi non sono usati nel risultato finale. Per ulteriori informa- 
zioni sul parametro di lunghezza, vedere la sezione Assegnazione di valori. 


Espressione indica una combinazione di operazioni aritmetiche di addizione, 
sottrazione, moltiplicazione o divisione. Queste espressioni sono come numeri 
(costanti intere o espressioni di sostituzione aventi valori interi) segni (+, —, 
* per moltiplicazioni, e / per divisioni) e anche parentesi aperte e chiuse per ope- 
razioni di gruppo. Le caratteristiche di queste espressioni aritmetiche e le rego- 
le per costruirle sono mostrate qui di seguito: 

‘ I segno meno (—) può indicare sia un numero negativo che una operazione di 
sottrazione. Per esempio: 


// EVALUATE Pi=-h+-5 


è valido e assegna —-9 al parametro 1. 
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Gli spazi in bianco non sono ammessi nell’ambito di un'espressione di assegnazio- 
ne, per esempio: 


// EVALUATE P1 = 1+2 
none valida, ma: 

// EVALUATE Pl=1+2 
è valida. 


Le operazioni di moltiplicazione e divisione hanno una priorità più alta delle addizioni 


‘ e sottrazioni. In altre parole le moltiplicazioni e divisioni vengono eseguite prima del- 


le addizioni e sottrazioni. Una parentesi aperta indica l’inizio di una operazione alge- 
brica e una parentesi chiusa la sua fine. Le operazioni tra parentesi vengono esegui- 
te prima. Fino a 30 operazioni possono essere raggruppate nell'intera espressione. 


In una operazione di divisione, il resto è perduto. Non viene eseguito l’arrotonda- 
mento. Per ottenere il resto si deve moltiplicare il quoziente per il divisore, e sottrar- 
re il risultato dal dividendo. Per esempio: 


// BVALUATE P1=17/5 P2=17-(?12*5) 
assegna il quoziente al paramentro 1 e il resto al parametro 2. 
Se si tenta di dividere per zero, viene segnalato un errore. 


Il risultato di ciascun operando in una espressione può essere al massimo di 15 valo- 
ri. Una espressione con un valore superiore non darebbe affidamento. 


Esempio 1 


Questo esempio assegna il valore 246 al parametro 1 e il valore —1 al parametro 
2. Il parametro 1 ha una lunghezza di 3 e il parametro 2 ja una lunghezza di 2. 


// EVALUATE P1=123+123 P2=0001+2-ì 


Esempio 2 


Questo esempio assegna il valore 00246 al parametro 1. ll parametro 1 ha una 
lunghezza di 5. 


// EVALUATE P1,5=123+123 


Esempio 3 


Se il parametro 3 ha un valore di 123, il parametro 9 ha un valore di 30 e il pa- 
rametro 10 ha un valore di 5, questo esempio assegna il valore 00125 al parame- 
tro 30. Il parametro 30 ha una lunghezza di 5. 

// EVALUATE p?9?,?10?=?32+2 


verrebbe valutato come: 


// EVALUATE P30,5=123+2 


Esempio 4 


Se il parametro 1 ha un valore di 3 e il parametro 2 il valore di 7, questo esempio 

i assegna il valore di 25 al parametro 3. Poichè le moltiplicazioni e le divisioni hanno 
priorità sulle addizioni e sottrazioni, il valore nel parametro 1 è moltiplicato per il va- 
lore del parametro 2. Poi 4 viene sommato al risultato. 


// EVALUATE P3=4+?197*?2? 
Esempio 5 


Se il parametro 1 ha il valore di 5, questo esempio assegna il valore di 30 al parame- 
tro 2. L'operazione di addizione, essendo tra parentesi, viene eseguita prima della 
moltiplicazione. 

// EVALUATE P2=3#(?2124+5) 


Esempio 6 


Questo esempio mostra come creare un file sulla base della dimensione di due file 
di lavoro. | fule CUSTMST e WORK sono due file residenti che contengono pa- 


recchi record. 


// EVALUATE P64=?F'A,CUSTMST'?+?F'A,WORK"? 
BLDFILE NEWFILE,S,RECORDS,?64?,100 


Per esempio, se il file CUSTMST contenesse 200 record e il file WORK contenes- 
se 150 record, ie specifiche verrebbero valutate come: 


// EVALUATE P64=200+150 
BLDFILE NEWFILE,S,RECORDS,350,100 


Valutazione di espressioni di sostituzione 


// EVALUATE espressione 





espressione può essere una o più espressioni di sostituzione. Ciascuna espressione 
deve essere separata da uno o più spazi in bianco, Le espressioni sono valuta- 
te da sinistra a destra. | risultati di un'espressione possono essere usati in 
una espressione successiva. 


Esempio 1 


Questo esempio assegna il valore ABC al parametro 1 soltanto se il parametro 1 
non ha un valore: 


// IF ?1?/ EVALUATE ?1'ABC'? 


Esempio 2 


Questo esempio assegna il valore MYLIB al parametro 3 se il parametro 3 non ha 
un valore e assegna un valore PROC al parametro 2 se il parametro 2 non ha un 


va valore. 


// EVALUATE ?3'MYLIB'? ?2'PROC'? 
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Impostazione del Codice di Ritorno 


E’ possibile salvare il codice di ritorno da un lavoro, eseguire un secondo lavoro 
ed impostare di nuovo il codice di ritorno al valore che aveva nel primo lavoro. 


/) EVALUATE CDennnn 





CD indica che il codice di ritorno deve essere ripristinato. 


nnnn indica il valore a quattro cifre del codice di ritorno da ripristinare. 


Esempio 


In questo esempio, la prima specifica EVALUATE salva il valore del codice di 
ritorno per il programma 1 e la seconda specifica, EVALUATE ripristina il valore 
del codice di ritorno per il programma 3. : 


// LOAD PROG1 

// RUN 

* Salva il codice di ritorno per PR0G3 

// EVALUATE P6l,k=?CD? 

// ALLOCATE UNIT-Il sWAIT-NO : 

* Modifica il codice di ritorno e il modulo a minidischi non 
è disponibile 

// LOAD PROG2 

// RUN . 

* Ripristina il codice di ritorno da PROG1 

// EVALUATE CD=?6k? 

// LOAD PROG3 

// RUN 
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SPECIFICHE GOTO E TAG 


Le specifiche GOTO e TAG consentono di saltare gruppi di specifiche nell’ambito 
di una procedura. Usando le specifiche GOTO e TAG invece di parecchie espres- 
sioni IF, è possibile ridurre il numero di espressioni che il SSP deve elaborare du- 
rante la generazione della procedura. 


// GOTO identificazione 


. // TAG identificazione 





Una specifica GOTO fa sì che il SSP salti alla specifica che segue una specifica 
TAG con la stessa identificazione. {Più di una specifica TAG in una procedura - 
può avere la stessa identificazione. ll sistema salta alla successiva specifica TAG 
con l’identificazione richiesta). Il SSP cerca la specifica destinazione TAG nel- 
l'ambito della procedura). La ricerca inizia con la specifica che segue la specifica 
GOTO. Se il SSP non trova la specifica di destinazione prima di raggiungere la 
fine della procedura, il SSP va alla prima specifica nella procedura e riprende la 
ricerca. 


Quello che segue è un esempio delle specifiche GOTO e TAG; 


*Esempio di specifica GOTO e TAG; 


// GOTO A 
a Queste specifiche sono saltate 
// TAG A L'elaborazione riprende da questa specifica 


La parola TAG non può essere sostituita, per esempio: 


// EVALUATE P1=TAG 


// GOTO A 
DI di 
non è valido, 
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Esempio 


Una procedura denominata PROC ne esegue altre quattro: STEP1, STEP2, 
STEP3 e STEPA. Normalmente per avviare PROC l'operatore immette: 


PROC 


Se l'operatore cancella PROC in qualche punto, la procedura può essere riavviata 


nel punto cancellato immettendo 


PROC RESTART,nome passo 


nome passo è STEP1, STEP2, STEP3 o STEPA, 


Le seguenti sono le specifiche di PROC: 


// IF 2123 IF 2223 
// IFF ?1?=RESTART 
// IFF ?1?=RESTART 
// IF ?22=STEP1 
// IF 222=STEP2 
// IF 22?=STEP3 
// IF. 222=STEPÌ 


GOTO STEPI1 (STEP1 IS THE DEFAULT) 
* 'INCORRECT ENTRY! 

CANCEL 

GOTO STEPI 

GOTO STEP2 

GOTO STEP3 

GOTO STEPÀ 


// * ‘INCORRECT ENTRY! 


// CANCEL 

// TAG STEPI 
STEP1 

// TAG STEP? 
STEPO 

// TAG STEP3 
STEP3 

// TAG STEPÀ 
STEPÙ 








SPECIFICA PAUSE 


La specifica PAUSE interrompe l'elaborazione di un lavoro e visualizza un mes- 
maggio sull'unità video che ha presentato il lavoro. Se fa specifica PAUSE è in un 
lavoro eseguito dalla coda di lavori o in un lavoro che è stato rilasciato dall'unità 
video richiedente, la specifica PAUSE visualizza un messaggio sulla console di si- 
stema. L'operatore può quindi riavviare il lavoro selezionando l'opzione O. Il 
sistema continua quindi l’elaborazione delle specifiche che seguono PAUSE. 


Quantunque la lunghezza di messaggio possa arrivare fino a 500 caratteri, vengo- 
no visualizzati soltanto i primi 68. Inoltre, soltanto i primi 113 caratteri sono 
scritti sul file storico, cronologico. 


// PAUSE | ‘testo messaggio | 





‘tasto messaggio’ specifica il messaggio da visualizzare quando il lavoro compie 
una pausa. }l messaggio deve essere contenuto tra apici (‘). Se il testo del 
messaggio contiene apici incorporati (come ad esempio l'apice in l'orologio). 
occorre immetterlo con due apici (per esempio: ‘l’’orologio’). 


Se non è specificato un testo di messaggio, viene visualizzato il messaggio 
seguente: 


PAUSE -- quando pronti, battere 0 per continuare 


Esempio 


In questo esempio la specifica PAUSE informa l'operatore che il programma 
paghe e stipendi è completo. L'operatore deve immettere uno 0 (zero) per conti- 
nuare. 


// LOAD PAYROLL 

// FILE NAME-EMPLOY 

// RUN 

// PAUSE ‘Completato programma PAYROLL' 
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SPECIFICA RESET 


E’ possibile avere fino a 255 livelli di procedura, In ogni caso, per alcune applica- 
zioni si desidera avere molti più livelli di richiamo di procedura. Per esempio, una 
procedura potrebbe richiamare se stessa per un numero indeterminato di volte. 
La specifica RESET richiama la procedura e indica che deve essere trattata come 
procedura di primo livello, cioè quando la procedura richiamata dalla specifica 
RESET è terminata, il controllo non è riportato al livello di procedura che con- 
tiene RESET. 


// RESET nome procedura [none \ibreria| paraml,param?2,..., 


_ dati programma 
*ALL 





nome procedura specifica il nome della procedura che viene richiamata. 
nome libreria specifica il nome della libreria contenente la procedura. 


param1, param2... sono parametri di procedura opzionali. La procedura specifica- 
ta dal nome di procedura diventa una procedura di primo livello. (Il control- 
lo non è riportato alla procedura contenente la specifica RESET). E’ possibi- 
le specificare un massimo di 64 parametri. Vedere la Specifica OCL INCLU- 
DE per ulteriori informazioni sul modo in cui è possibile indicare i parame- 


tri. 


dati programma i dati da passare al programma sulla prima operazione di immis- 
sione dall'unità video. 


*ALL specifica che tutti i 64 parametri dal livello di procedura corrente devono 
essere passati alla procedura specificata. 


Esempio 


Una procedura denominata PROCA visualizza una lista di opzioni ad un operato- 
re e gli dice di immettere una di esse. PROCA quindi richiama la procedura speci- 
ficata dall'opzione scelta. Quando quella procedura è completata, PROCA richia- 
ma se stessa e il processo viene ripetuto, In questa applicazione, PROCA deve es- 
sere in grado di richiamare se stessa un qualsiasi numero di volte. Seguono le spe- 
cifiche del membro di procedura denominato PROCA. 


* THIS IS PROCEDURE PROCA 
// * ‘ENTER ONE OF THE FOLLOWING OPTIONS: ' 
* ! 1. RUN WEEKLY PAYROLL' 
x 1 2. PRINT CURRENT INVENTORY! 
//* * 3. RUN WEEKLY BILLINC' 
* '* ll, STOP! 
// IF ?1R?=hì CANCEL 
// IF ?1?9=1 PAYROLL WEEKLY 
// IF 21?2=1 RESET PROCA 
// IF ?1?=2 INVENT 
// IF ?1?=2 RESET PROCA 
// IF ?1?=3 BILLING WEEKLY 
// IF ?1?=3 RESET PROCA 
// * *?1? IS A WRONG OPTION! 
// RESET PROCA 
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SPECIFICA RETURN 


Se viene elaborata la specifica RETURN in una procedura di primo livello, la 
procedura restituirà il controllo al terminale richiedente per la specifica successiva 
qualora sia richiesta un'ulteriore immissione. Se è richiesta un'ulteriore immissione 
e l’unità video richiedente non esiste (per esempio la procedura viene eseguita 
dalla coda lavori), viene visualizzato un messaggio di errore. Se non è richiesta 
un'ulteriore immissione, il lavoro termina. Se viene elaborata in una procedura 
nidificata, la specifica RETURN restituisca il controllo alla procedura richiamante 
per la successiva specifica. 


// RETURN [sari | 


Se viene specificato *ALL, tutti i 64 parametri dai livello di procedura corrente, 
sono passati al livello di procedura precedente. Ciò fa sì che tutti i parametri per 
tutta la procedura precedente, vengano compeltamente sostituiti. 


Se non è specificato *ALL, i parametri per il livello di procedura precedente 
sono lasciati inalterati. 


Esempio 1 


Questo esempio mostra come terminare una procedura. usando una specifica 
RETURN in modo che il sistema non perda tempo a elaborare le specifiche di 
commento. 


// LOAD PROGA 

// FILE NAME- INPUT 

// FILE NAME-OUTPUT 

/) RUN 

//] RETURN 

* Questa procedura legge il file chiamato INPUT, e 
* crea il file chiamato OUTPUT 


. Esempio 2 


Questo esempio mostra come i parametri vengono passati da una procedura 
PROC2 alla procedura che l’ha richiamata. 


* Procedura PROC2 
// EVALUATE P1=FILEA P2=INPUT P3=0UTPUT 
// RETURN *ALL 
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Capitolo 4. Procedure 


Questo capitolo descrive le procedure del Sistema/36 fornite dalla IBM. In que- 
sto manuale non sono descritte le procedure che vengono usate per installare e 
verificare i programmi su licenza. Per informazioni su tali procedure, vedere il 
manuale Modifica della configurazione del sistema. 


Per ciascuna procedura descritta in questo capitolo, sono fornite le seguenti in- 
formazioni: 


e La funzione della procedura. 

e li formato di sintassi del comando di procedura che richiama la procedura 
stessa. Per una descrizione delle regole usate per i formati di sintassi, vede- 
re Convenzioni usate per la descrizione dei formati di sintassi. 


e Descrizione dei parametri usati nel comando di procedura. 


e Unoo più esempi del mado in cui usare la procedura e dei modo in cui im- 


mettere il comando di procedura o le specifiche per eseguire la procedura’ 


stessa. 


Una volta collegati al Sistema/36 è possibile usare il supporto di testi esplicativi 
del sistema per eseguire queste procedure. ll supporto di testi esplicativi del si- 
stema è costituito da menù, schermi di richiesta e testo esplicativo. | menù con- 
sentono di scegliere la funzione che si vuole eseguire. Quando si sceglie una 
opzione da un menù: 


e Viene visualizzato un altro menù {quando si scelgono le opzioni, ciascuna 
fornisce ulteriori spiegazioni a proposito della funzione che si vuole ese- 
guire). 


e Compare uno schermo di richiesta per una procedura o un comando. 


Gli schermi di richiesta consentono di eseguire procedure per svolgere la funzio- 
ne. Il testo esplicativo spiega i menù, le opzioni dei menù, le procedure, i co- 
mandi e i parametri per le procedure e i comandi. 


Per ulteriori informazioni sul supporto esplicativo del sistema, vedere la Proce- 
dura HELP, 
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Procedura 
SSP 


ALERT 
ALOCFLDR 
ALOCLIBR 
ALTERCOM 
ARCHIVE 
BLDFILE 
BLDINDEX 
BLDLIBR 


BLDMENU 


BUILD 


CATALOG. . 


CHNGEMEN 
COMPRESS 
CONDENSE 
COPYDATA 
COPY 


COPYPRT 


CREATE 
DATE 
DEFINEID 
DEFINEPN 
DEFINX21 


DELETE 
DELNRD 
DISABLE 
EDITNRD 
ENABLE 
ERR 
FORMAT 


FROMLIBR 
HELP 
HISTORY 
INIT 
JOBSTR 
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La tabella che segue mostra il nome del programma di utilità SSP o il nome della 
specifica OCL che viene eseguita o elaborata dalle procedure SSP che usano speci- 
fiche OCL o programmi di utilità. 


Spec. OCL 
elaborata 


Progr. Util. 
SSP eseguito 


$CZUT 
$TMSERV 
$MAINT 
$SETCF 
$TMSERV 
$FBLD 
$FBLD 
$MAINT 


$BMENU 
$MAINT 
$MGBLD 


$BUILD 
$LABEL 
$MAINT 
$FREE © 
$MAINT 
$COPY 

$DUPRD 


$UASF 
$UASC 


$MGBLD 
DATE 
$IDSET 
$PNLM 
$XNLM 


$DELET 
$SINDL 
$IEDS 
$SINR 
$IENBL 
$CPPE 
$SFGR 


$MAINT 

$HELP 

$HIST 

$INIT 

$MAINT JOBO 


Procedura 
SSP 


KEYSORT 


LIBRLIBR 


LINES 
LISTDATA 


LISTFILE 


LISTLIBR 
LOG 
NOHALT 
POST 
PRINT 


PRINTKEY 
REMOVE 
RENAME 
REQUESTX 
RESPONSE 
RESTEXTN 
RESTFLDR 
RESTLIBR 
RESTNRD 


RESTORE 
RETRIEVE 
SAVE 
SAVEEXTN 
SAVEFLDR 
SAVELIBR 
SAVENRD 
SECDEF 


SECEDIT 


SECLIST 


Spec. OCL 
elaborata 


Progr. Util. 
SSP eseguito 


$DDST 
$MAINT 

FORMS 
$ COPY 


$BICR 
$COPY 
$MAINT 
$TCOPY 


$MAINT 
LOG 
NOHALT 


‘$POST 


FORMS 


$SETCF 
$MAINT 
$RENAM 
#GCFR 
$ARSP 
$XREST 
$TMSERV 


‘ $MAINT 


$COPY RA 
$SINCT 


$ COPY 
$TMSERV 
$COPY 
$XSAVE 
$TMSERV 
$MAINT 
$COPY 
$PRUID 
$RRESC 
$PRCED 
$PRUED 
$RREDT 
$RRTED 
$PRCLT 
$PRLST 
$RRLST 
$RRTLT 


Procedura 
SSP 


SECREST 
SECSAVE 


SET 
SETCOMM 


SLIB 
STARTM 
STOPM 
SWITCH 
SYSLIST 


TAPECOPY 
TAPEINIT 
TOLIBR 
TRANSFER 


Progr. Util. 
SSP eseguito 


$PRURS 
$RRSTR 
$PRUSV 
$RRSAV 
$SETCF 
$SETCP 


$MMST 
$MMSP 


$TCOPY 
$TINIT 
$MAINT 
$BICR 


Spec. OCL 
elaborata 


LIBRARY 


SWITCH 
SYSLIST 
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PROCEDURA #STRTUP1 


E’ possibile creare la procedura #STRTUP1 per avviare i propri lavori che devono 
essere eseguiti durante il processo di caricamento del programma iniziale (IPL), 
prima che vengano eseguiti altri lavori. 

#STRTUP1 è un nome di procedura riservato che viene cercato durante \'IPL, Se 
la procedura è trovata, inizia l'esecuzione. Se non è trovata, non si verifica alcun 
errore. Non è possibile trasmettere parametri alla procedura. 


La procedura #STRTUP1 prevede l'esecuzione a sistema dedicato e cioè quando 
non sono in corso di esecuzione altri programmi. Poiché questa procedura viene 
eseguita prima del termine dell'IPL, talune funzioni di sistema, ad esempio la 
stampa differita e la coda di lavori, non sono state ancora inizializzate. Usando 
questa procedura, non si deve cercare di eseguire alcun programma che abbia 
emissioni in stampa o che avvii altri programmi. 


ATTENZIONE 

Occorre assicurarsi che nessuna procedura che si include nella procedura 
#STRTUP1 contenga un programma sempre residente in memoria (NEP); se si in- 
cludesse tale procedura, l’IPL non verrebbe mai completato. 


Per creare proprie procedure, vedere il Capitolo 2, Creazione di proprie procedu- 
re. E’ possibile inserire la procedura #STRTUP1 nella libreria di sistema 
(#LIBRARY) o nella libreria di collegamento dell’operatore di sistema. 


La Figura 5 a pag. 4-4 mostra la relazione tra l’IPL e la procedura #STRTUP1. 


#STRTUP2 è un'altra procedura che può essere eseguita come parte del processo 
IPL; vedere la Procedura #STRTUP2, 
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Premere pulsante carica- 
mento sul pannello di 
controllo 







Collegamento dell'ope- 


; IPL 
ratore al sistema 







Inizio esecuzione 
procedura #STRTUP1 











Inizio esecuzione 
procedura #STRTUP2 


Collegamento di altri 
operatori al sistema 







Figura 5. Relazione tra IPL, #STRTUP1 e #STRTUP2, 


Esempio 


Questo esempio mostra tre procedure che è possibile includere nella procedura 
#STRTUP1, che è possibile memorizzare nella libreria di sistema (#LIBRARY). 


* #STRTUP1 procedura : 

* Impostazione a 3 del livello di gravità di risposta automatica 
per il sistema 

NOHALT 3,SYSTEM 

* 

* Comprimere la libreria di sistema 

CONDENSE #LIBRARY 

* 

* Comprimere il disco 

COMPRESS 


PROCEDURA #STRTUP2 


E’ possibile creare la procedura #STRTUP2 per avviare i propri lavori che de- 
vono essere eseguiti come parte del processo di caricamento del programma ini- 
ziale (IPL), mentre altri lavori vengono eseguiti. 

#STRTUP2 è un nome di procedura riservato che viene cercato durante l’IPL. 
Se la procedura viene trovata, inizia l'esecuzione; se non è trovata, non si verifica 
alcun errore. Mentre questo lavoro viene eseguito, possono.essere avviati altri la- 
vori e altri operatori possono collegarsi. Non possono essere passati parametri 
alla procedura. 


E’ possibile usare questa procedura per eseguire le funzioni desiderate ogni voitta 
che si esegue un IPL ma non si vuole impedire che altri lavori vengano iniziati 
mentre questo lavoro viene eseguito. 


E’ possibile inserire la procedura #STRTUP?2 nella libreria di sistema (HLIBRARY) 
o nella libreria di collegamento dell'operatore di sistema. 


La Figura 5 mostra la relazione tra IPL e la procedura #STRTUP2. #STRTUP1 
è un’altra procedura che può essere eseguita come parte del processo IPL. 


Esempio 


x 


Questo esempio mostra una procedura che è possibile includere nelia procedura 
#STRTUP2 che si potrebbe memorizzare nella libreria di sistema (#LIBRARY). 


* #STRTUP2 procedura 
* Lista del contenuto del disco 


CATALOG 
* 


* Abilitazione di un sottosistema 
ENABLE SUBSYS1 
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PROCEDURA ALERT. i 


La procedura ALERT avvia il supporto di avviso, che permette di specificare quale 
messaggio di sistema in un insieme predefinito di messaggi di sistema dovrà gene- 
rare messaggi di avviso e fornire l'interfaccia per inviare una notifica di avviso. Questa 
consente di generare i propri messaggi ed inviarli al sistema principale che riceve 


gli avvisi. 


| messaggi di avviso vengono inviati al sistema principale di una rete comunicazio- 
ne tramite il sottosistema APPC (Advanced program - to - program communication). 
Per maggiori informazioni vedere il manuale COMMUNICATIONS AND SYSTEMS 
MANAGEMENT GUIDE. 


metri particolari organizzazioni nell’area dati locale; pertanto l'utente dovrà utilizza- 


| La procedura ALERT esegue il programma di utilità $CZUT ma richiede per i para- 
re la procedura ALERT e non scrivere proprie procedure. 


NOTIFY — 


| ALERT |MAINTAIN 





MAINTAIN specifica che deve essere eseguita la gestione, del membro messaggi 
di sistema o dei membri origine d’avviso. 
Se non viene specificato alcun parametro, viene assunto MAINTAIN. 


NOTIFY specifica che una notifica d’avviso sta per essere inviata al sistema princi- 
pale che sta per ricevere l'avviso. 
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PROCEDURA ALOCFLDR 


La procedura ALOCFLDR consente di riorganizzare una cartella e variare la sua 
ampiezza. 

Quando si riorganizza una cartella, i membri di cartella vengono posizionati all’inizio 
della cartella per ridurre al massimo il numero degli indici di cartella. Questo può in- 
crementare il rendimento poichè la cartella può utilizzare al meglio lo spazio su disco. 


Si può inoltre aumentare o diminuire la dimensione della cartella, o renderla il più 
piccolo possibile. Se non si varia la dimensione della cartella, questa rimane come 
era prima delia riorganizzazione. 


La procedura ALOCFLDR esegue il programma di utilità $TMSRV. 


DECR 
INCR 


ALOCFLDR nome cartella,|MIN [emescnro in blocchi 





nome cartella specifica la cartella che deve essere riorganizzata ed eventualmente 
modificata nella sua dimensione. 


MIN specifica che la cartella deve essere il più piccola possibile, con soltanto membri 
di cartella. E come eseguire la procedura CONDENSE con il parametro FOLDER. 


DECR specifica che la cartella deve essere diminuita della quantità indicata. Se si 
specifica DECR, si deve anche specificare l'ampiezza in blocchi. 


ampiezza in blocchi specifica il numero di blocchi da aumentare o diminuire. Si può 
specificare un numero da 1 a 6553. Un blocco contiene 10 settori. Se si speci- 
fica una ampiezza, si dovrà specificare anche DECR o INCR. 


Esempio 


Questo esempio mostra l'ampiezza di una cartella chiamata MYFLDR aumentata di 
10 biocchi. 


ALOCFLDR MYFLDR,INCR,10 
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PROCEDURA ALOCLIBR 


La procedura ALOCLIBR consente di aumentare o diminuire la dimensione di 
una libreria dell'utente o della libreria di sistema (#LIBRARY). E’ possibile inol- 
tre modificare la dimensione di un indirizzario di una libreria dell'utente o mo- 
dificare l’unità disco che contiene la libreria dell'utente, Se la libreria ha un’esten- 
sione (un'area separata sul disco che contiene i membri di libreria che non trova- 
no posto nella libreria), l'estensione è combinata con ta libreria. Se la libreria non 
ha un'estensione, la dimensione della libreria, la dimensione dell’indirizzario o la 
locazione dell'unità disco devono essere modificate. Per la libreria di sistema 
(#LIBRARY), la dimensione dell'indirizzario e l’unità disco non possono essere 
modificate. 


Quando la libreria ALOCLIBR.è in esecuzione, nessun altro lavoro o terminale video 
può usare la libreria specificata. Se si tenta di eseguire la procedura ALOCLIBR per 
una libreria utilizzata da un altro lavoro, viene segnalato un errore e la procedura ALO- 
CLIBR non viene eseguita. Una volta in esecuzione, nessun altro lavoro può utilizza- 
re la libreria specificata fino a che non termini la procedura ALOCLIBR. 


E' possibile usare la procedura LISTLIBR o CATALOG per determinare se una 
libreria ha un'estensione. Vedere la Procedura LISTLIBR o la Procedura CATA- 
LOG per ulteriori informazioni. Per gli orientamenti sulla determinazione delle 
dimensioni delle librerie e degli indirizzari, vedere. il manuale Concepts and 
Programmer's Guide. 


Per creare una nuova libreria, vedere la Procedura BLDLIBR, La procedura 
ALOCLIBR esegue il programma di utilità $MAINT, 


ALOCLIBR nome libreria È [Ampiezza RESA , [ampiezza ii " 


libreria corrente Sa 


Al INCR 
A2 DECR 
A3 

Aù 

numero blocco 





nome libreria specifica la libreria che deve essere modificata. Se non è specificato 
alcun parametro, si presume la libreria corrente. Per modificare la dimensio- 
ne della libreria di sistema, immettere #LIBRARY. 


ampiezza libreria specifica la nuova dimensione in blocchi della libreria. Specifi- 
cando INCR o DECR, si indica di quanti blocchi la dimensione della libreria 
deve essere rispettivamente aumentata o diminuita. La dimensione massima 
della libreria è di 15000 blocchi. Un biocco contiene 2560 byte. Se non è 
specificata alcuna dimensione di libreria ed esiste un'estensione, la dimensione 
della libreria è aumentata soltanto nella quantità necessaria per contenere i 
membri nell’estensione. Se non è specificata alcuna dimensione di libreria e 
non esiste alcuna estensione, la dimensione della libreria non viene modificata. 
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ampiezza indirizzario specifica la nuova dimensione, in settori, dell’indirizzario 
della libreria. Specificando INCR o DECR, si indica di quanti settori l’indiriz- 
zario di libreria deve essere rispettivamente aumentato o diminuito. La di- 
mensione minima di indirizzario è di due settori; la dimensione massima è di 
2500 settori. Un blocco di libreria contiene 10 settori. Se non viene specifi- 
cata alcuna dimensione di indirizzario, la dimensione dell'indirizzario non vie- 
ne modificata. 


Per determinare il numero di entrate di indirizzario disponibili per un dato 
numero di settori, moltiplicare il numero di settori per 5 e sottrarre 7 dal ri- 
sultato. Per esempio, per 10 settori di indirizzario, è possibile avere fino a 
43 entrate (5 x 10 = 50, 50 - 7 = 43). 


A1 specifica che la locazione preferenziale del file su disco è sulla prima unità. 
Se è disponibile spazio, 'SSP inserisce la libreria sul primo disco. 


A2 specifica che la locazione preferenziale del file su disco è sulla seconda 
unità disco. Se è disponibile spazio, il sistema inserisce la libreria sulla secon- 
da unità disco. 


A3 specifica che la locazione preferenziale del file su disco è sul terzo disco. 
Se è disponibile spazio, l’SSP inserisce il file sul terzo disco. 


AA specifica che la locazione preferenziale del file su disco è sul quarto disco. 
Se è disponibile spazio, !'SSP inserisce il file sul quarto disco. 


numero blocco specifica la locazione del primo blocco della libreria. E' possibile 
specificare fino a 6 cifre ed è possibile usare la procedura CATALOG per de- 
terminare dove sono disponibili blocchi di spazio su disco. 


INCR indica che la dimensione della libreria e/o dell’indirizzario devono essere 
aumentati della quantità specificata. Devono essere specificate o una dimen- 
sione di libreria o una dimensione di indirizzario o entrambe. 


DECR indica che la dimensione della libreria e/o la dimensione dell’indirizzario 


devono essere decrementati delle quantità specificate. Se non viene specifi- 
cata una libreria o un indirizzario, questi vengono ridotti il più piccolo possibile. 
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Esempio 1 


Questo esempio mostra una libreria denominata MYLIB che viene modificata in 
250 blocchi. La dimensione dell’indirizzario viene modificata in 25 settori. 


ALOCLIBR MYLIB,250,25 


Esempio 2 


Questo esempio mostra le dimensioni di una libreria denominata MYLIB che vie- 
ne aumentata di 250 blocchi. La dimensione dell’indirizzario viene aumentata 
di 25 settori. 


ALOCLIBR MYLIB,50,25,,INCR 


Esempio 3 


Questo esempio mostra le dimensioni di una libreria denominata MYLIB che vie- 
ne diminuita di 10 blocchi. 


ALOCLIBR MYLIB,10,,sDECR 


PROCEDURA ALTERBSC 


Questa procedura è supportata soltanto per compatibilità con il Sistema/34 IBM. 


Quella che occorre usare sul Sistema/36 è la Procedura ALTERCOM. 


pr 


PROCEDURA ALTERCOM 
La procedura ALTERCOM modifica le opzioni di comunicazione per una linea 
di comunicazione specificata. Le modifiche sì applicano soltanto ai programmi 
eseguiti dalla stessa unità video su cuì si esegue la procedura ALTERCOM. Per 
modificare le opzioni in modo che siano interessate tutte le unità video, vedere 
la Procedura SETCOMM. 


Si può usare il comando STATUS COMM per visualizzare lo stato corrente degli 
elementi di comunicazione che è possibile modificare con la procedura ALTER- 
COM. 


Per sottosistemi di comunicazione BSC, è possibile modificare: 

e Il tipo di comunicazione 

e li tipo di commutazione 

e La velocità del modem (velocità intera o metà) 

®* Se deve essere usata una linea secondaria di riserva 

Per sottosistemi di comunicazione SDLC e terminali remoti, è possibile modificare: 
e ll tipo di linea di comunicazione 


e Ii tipo di commutazione 


e La velocità del modem (velocità metà o intera) 
e Se deve essere usata una linea di riserva secondaria 
e Îl valore di tempo scaduto SDLC 


e I numero dei tentativi ripetuti SDLC 


Per un sottosistema asincrono, è possibile modificare: 
e ll tipo comunicazioni 


e Il tipo di commutazione 
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Per le comunicazioni dati BSC a blocchi, è possibile modificare: 
e li tipo di linea di comunicazione 

e tipo di commutazione 

e L'ID del terminale remoto della linea commutata 

e L’ID del terminale locale della linea commutata 

e L'indirizzo tributario 

e Se gli spazi in bianco devono essere compressi o troncati 

e ll tempo di attesa prima che si presuma una condizione di errore 
e Se deve essere usato il modo a file multipli 3741 

e ll separatore di record 

e Il numero dei tentativi ripetuti su errore 

e La velocità del modem (velocità intera o metà) 


e Se deve essere usata una linea di riserva secondaria 


Se vengono omessi dei parametri, i corrispondenti valori nel record di configura- 
zione di comunicazione dell'unità video non sono modificati. 


La procedura ALTERCOM può essere eseguita da qualsiasi unità video. 


141.1 








Pagina lasciata intenzionalmente bianca 








paid. Begin 


AA 








Se deve essere abilitato un sottosistema di comunicazioni ed è richiesta la procedu- 
ra ALTERCOM, occorre eseguire la procedura ALTERCOM dalla stessa unità video 
su cui si esegue la procedura ENABLE. Se si esegue ALTERCOM mentre un sottosi- 
stema è abilitato, il sottosistema deve essere disabilitato e abilitato di nuovo prima 
che vengano usati i nuovi valori. 


La procedura ALTERCOM non può essere eseguita dalla coda lavori o avviata da 
una specifica OCL EVOKE. 


Le modifiche effettuate da ALTERCOM rimangono valide fino a che: 


e Le opzioni non sono di nuovo modificate dalla procedura ALTERCOM o dal 
programma di utilità $SSETCF 


e La libreria di sistema non è ripristinata da un IPL da minidisco 
e Il sistema non è configurato di nuovo 
e Nonè stato eseguito un IPL dopo la procedura SETCOMM. 


Vedere il manuale Using Sistem/36 communications per ulteriori informazioni sui 
sottosistemi di comunicazione. Vedere il manuale Programmazione RPG Il e il ma- 
nuale Programming with Assembler per informazioni relative alle comunicazioni da- 
ti BSC a blocchi. 


La procedura ALTERCOM esegue il programma di utilità $SSETCF. 


ALTERCOM |numero linea|,, SWITCHED,{AA), | id remoto|,| id locale], 
1 maÙ | R R 
MC = 


NONSWITCH,,,, 


MULTTRIB,,..|indirizzo tributario 
R 


MULTICONT,,,, 


COMPRESS — | NONMULT R HALF 


NONE 5 [tempo attesa bsc a fc ss 4 da , 
TRUNCATE 


Fe | : (numero ripetizioni bsc |, [tempo scadenza si sessi 


NONSNBU i: - |tizioni sdlc | 





Quantunque ciascun parametro sia facoltativo, deve esserne specificato almeno 
uno. 


numero linea specifica il numero della linea di comunicazioni di cui si deve mo- 
dificare una o più caratteristiche, E’ possibile immettere 1, 2, 3 o 4. Se non 
viene immesso un numero di linea, si presume la linea numero 1. 


SWITCHED specifica che si tratta di una linea di comunicazioni commutata, pun- 
to a punto. 
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AA specifica che se Il modem di comunicazioni è del tipo a risposta automatica, 
il sistema deve rispondere automaticamente alla chiamata. 


MA specifica che l'operatore di sistema deve rispondere manualmente alla chia- 
mata. 


MC specifica che l'operatore di sistema deve chiamare manualmente l’unità con 
cui deve comunicare, Per la chiamata automatica, specificare MC e specificare 
l'elenco telefonico da usare nella configurazione del sottosistema, 


id remoto specifica il valore esadecimale dell'ID del terminale remoto, E’ possibi- 
le specificare 2, 4, 6 o 8 cifre decimali, Se l'ID del terminale remoto contie- 
ne più di otto cifre decimali, ID deve essere specificato nel programma. 


R specifica che l'ID remoto deve essere ripristinato (impostato a esadecimale 
00). 


id locale specifica il valore esadecimale dell'iD della stazione locale. E’ possibile 
specificare 2, 4, 6 o 8 cifre esadecimali. Se l'ID della stazione locale com- 
prende più di otto cifre esadecimali, l'ID deve essere specificato nel program- 
ma. 


R specifica che l'ID remoto deve essere ripristinato (impostato a esadecimale 
00). 


NONSWITCH specifica che la linea deve essere una linea di comunicazione non 
commutata, punto a punto. 


MULTTRIB specifica che il sistema è una stazione tributaria multipunti. 


indirizzo tributario specifica l'indirizzo del sistema sulla linea di comunicazione a 
derivazione multipla. L'indirizzo tributario è il valore esadecimale di uno del- 
la coppia di caratteri d'indirizzamento della stazione tributaria. Per esempio, 
per indicare i caratteri di indirizzamento EBCDIC SS verrebbe immesso il va- 
lore E2 (E2 è l’equivalente esadecimale della lettera S in EBCDIC). Se non è 
specificato alcun indirizzo, viene usato il valore nel programma. 


R specifica che l'indirizzo tributario deve essere ripristinato (impostato a esa- 
decimale 00). 


Vedere /ndirizzamento della stazione tributaria e Indirizzamento della stazio- 
ne tributaria e caratteri d’interrogazione per l’indirizzamento tributario e i 
Caratteri d’interrogazione. 


MULTCONT specifica che Îl sistema è una stazione di controllo multipunti. Que- 
sto parametro non può essere usato con BSC. 


SHM specifica che la linea utilizza la rete X.21 (in modo scollegamento se non atti- 
va). Per ulteriori informazioni vedere la procedura DEFINX21. Per ii modo scol- 
legamento se non attiva, vedere il manuale Using System/36 Communications. 


NONE specifica che non devono essere eseguiti né la compressione degli spazi 
vuoti né il troncamento. 


COMPRESS specifica che gli spazi vuoti incorporati devono essere compressi. 
TRUNCATE specifica che ali snazi di coda devono essere troncati (e cioè eliminati). 


tempo attesa bsc specifica il numero di secondi che il BSC deve lasciare passare 
perché il programma dell'utente del Sisterma/36 emetta una richiesta BSC pri- 
ma di indicare ché si è verificato un errore, E’ possibile specificare qualsiasi 
numero decimale da 1 a 999. Zero indica che deve essere usato il valore di 
tempo zero nel programma, 
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R specifica che deve essere ripristinato il tempo di attesa BSC impostato a 
esadecimale 00). 


MULTIFILE specifica che è possibile trasmettere o ricevere più di un file (tipo 


3740). 


NONMULT specifica che non è possibile trasmettere o ricevere file multipli, 


separatore record specifica il carattere da utilizzare per indicare la fine di un record 


e l’inizio dell'altro quando vengono inviati record in blocchi. 

Tutti i valori sono validi eccetto 00, 01, 02, 03, 10, 1F, 26, 2D, 32, 370 3D. 
Vedere il manuale Programmazione RPG Il o il manuale Programming with As- 
sembler per ulteriori informazioni sui caratteri separatori di record. 


R specifica che il separatore di record deve essere ripristinato a esadecimale 
00 Se questo parametro viene omesso: 


e Per programmi RPGII, se questo parametro viene omesso, e se è specifi- 
cato COMPRESS o TRUNCATE, viene usato un separatore di record esa- 
decimale 1E, altrimenti non viene usato alcun separatore di record. 


e Se il programma è un programma Assembler, si verifica quanto segue: 
— Se è specificato un separatore di record nel programma, viene usato 
quel separatore di record. 
— Se vengono specificati COMPRESS, TRUNCATE o record di lun- 
ghezza variabile e nel programma non è specificato alcun separatore 
di record, viene usato un separatore di record esadecimale 1E; altri- 
menti non viene usato alcun separatore di record, 


FULL specifica che deve essere usata la velocità interna nominale del modem. 


HALF specifica che deve essere usata la velocità metà di quella nominale del mo- 


dem. Ciò è valido soltanto se il modem supporta la velocità dimezzata. 


SNBU specifica che deve essere usata la linea di riserva rete commutata se si ve- 


rifica un guasto sulla linea primaria non commutata, 


Ciò è valido soltanto se il modem e il sistema a distanza supportano la riser- 
va rete commutata. 


Se per BSC è stato specificato SNBU e non è specificata una chiamata ma- 
nuale, una risposta manuale o una risposta automatica, il collegamento diven- 
ta una chiamata manuale o una risposta manuale in relazione alla prima ope- 
razione della linea di comunicazione eseguita dal programma. Se la prima 
operazione di linea è un'operazione di trasmissione, si presume una chiamata 
manuale. Se la prima operazione di linea è un'operazione di ricezione, si pre- 
sume una risposta automatica. 


NOSNBU specifica che non deve essere usata la linea di riserva rete commutata. 


numero ripetizioni bsc specifica il numero di tentativi ripetuti della trasmissione 


nel caso di un errore. È possibile specificare qualsiasi numero decimale da 1 
a 255. Se si specifica 255, il BSC tenta ripetutamente di ottenere una rispo- 
sta dal sistema remoto. 


R specifica che deve essere ripristinato il contatore dei tentativi ripetuti BSC 
(impostato a esadecimale 00). 


tempo di scadenza sdic specifica il valore di tempo scadenza a incrementi di 
mezzo secondo. È possibile specificare un numero da 05 a 80, dove le prime 
cifre indicano i secondi e le seconde cifre rappresentano i mezzi secondi. Per 
esempio 25 indica due secondi e mezzo e 30 indica 3 secondi. 


numero ripetizioni sdlc specifica il numero di tentativi che devono essere ripetuti 
per una trasmissione. E’ possibile specificare un numero da 1 a 5. I{ numero 
indica il multiplo di 7 dei tentativi effettuati; per esempio, 2 significa 14 
tentativi. 


Esempio 1 


Specificare che la linea 1 deve essere commutata e che deve avere la risposta au- 
tomatica: i 


ALTERCOM 1,SWITCHED,AA 


Esempio 2 
Questo esempio mostra come modificare quanto segue: 
e Il numero di linea è 3 
e L'indirizzo tributario per la linea a derivazione muli è ‘TT’ (EBCDIC E3) 
ALTERCOM 3,MULTTRIB,,,,£3 


La rete di comunicazione a derivazione multipla potrebbe essere vista come segue: 


Sistema principale 









Sistema B 
Carattere di 
indirizzamento UU 


ETA 






Linea di comunicazione 
numero 3 





Sistema A 
Carattere di 
indirizzamento SS 


Sistema dell'utente 
Carattere di i 
indirizzamento TT 
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Le tabelle che seguono mostrano i caratteri di indirizzamento e di scansione che 
possono essere usati per le stazioni tributarie BSC del Sistema/36. | caratteri di 
scansione e di indirizzamento, devono essere usati in determinate coppie. Cioè 
una volta che viene scelto un carattere di indirizzamento, deve essere usato il ca- 
rattere di scansione complementare. | caratteri di indirizzamento e di scansione, 


sono assegnati dal sistema principale. 


Caratteri di indirizzamento e di scansione EBCDIC 
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Caratteri di indirizzamento e di scansione ASCII 


Carattere di Codice Carattere di Codice 
indirizzamento esadecimale indirizzamento | esadecimale 


PROCEDURA ALTERSDL 
Questa procedura è supportata soltanto per motivi di compatibilità con il Siste- 


ma/34 IBM; essa esegue una funzione simile alla procedura ALTERCOM. La pro- 
cedura da usare sul Sistema/36 è la Procedura ALTERCOM. 


PROCEDURA ARCHIVE 


La procedura ARCHIVE copia un membro di cartella o tutti i membri di cartella indi- 


cati su minidisco, nastro o nastro a cassetta. Il membro di cartella è memorizzato 
in un file, e l'indirizzo della cartella è cambiato per ricordare se il membro era stato 
copiato su un minidisco, nastro o nastro a cassetta, l'ID di volume del minidisco, 
nastro o nastro a cassetta, il nome del file che ha ricevuto la copia e la data della copia. 
La procedura ARCHIVE può lasciare il membro nella cartella, rimuovere il testo dal- 
la cartella e lasciare solo l’indirizzario, o rimuovere l’intero membro dalla cartella dopo 
che è stato copiato. 


La procedura ARCHIVE può archiviare un membro di cartella che era gia stato co- 
piato. Il sistema crea un nuovo file per contenere il membro, e l'indirizzario di cartel- 
la viene modificato. 
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147.1 


La procedura ARCHIVE esegue il programma di utilità STMSERV. Per archiviare un 
membro di cartella su minidisco: 


ARCHIVE folder nome, DOCUMENT, } MARKED! ,} KEEP 7 
MEMBER DELTEXT 
DELMEM 


giorni di 
conservazione|,Il,volume, [none membro | j 
999 


nome file AUTO 


nome membro NOAUTO 





| Per archiviare un membro di cartella su nastro o nastro a cassetta 


MEMBER] |DELTEXT 


ARCHIVE folder nome, DOCUMENT, | MARKED|,|KEEP ’ 
DELMEM 


giorni di E Ta volume, [ nome membro |, 


conservazione 
T 
999 S 


nome file |,,|AUTO |,|REWIND 
nome membro NOAUTO LEAVE 
“ar UNLOAD 





Nome cartella specifica il nome della cartella da cui devono essere archiviati membri. 


DOCUMENT specifica che il membro di cartella è un documento. Se non viene spe- 
cificato alcun parametro, viene assunto DOCUMENT. 


MARKED specifica che tutti i membri indicati sono archiviati. 


MEMBER specifica che solo il membro indicato nell’ottavo parametro deve essere 
archiviato. 


KEEP specifica che il membro non deve essere cancellato dalla cartella dopo la sua 
archiviazione. Se non viene indicato nessun parametro viene assunto KEEP. 


DELTEXT specifica che il testo del membro deve essere cancellato dalla cartella dopo 
che il membro è stato archiviato. L'indirizzario del membro rimane nella cartella. 


DELMEN specifica che l’intero membro (testo e indirizzario) deve essere cancellato 
dalia cartella dopo che il membro è stato archiviato. 


GIORNI DI CONSERVAZIONE specifica i giorni di conservazione del file su minidi- 
sco o nastro. Può essere un qualsiasi numero da 0 a 999. Se non specificato, 
viene assunto 999. Se si indica 999 il file diviene un file permanente. Se non 


si specifica nulla, viene assunto 999. 


11 specifica che il file che conterrà il membro è un minidisco. 


T1 o T2 specifica che il file che conterrà il membro è su nastro o nastro a cassetta 
e quale tipo unità riceverà la copia del membro. 


ID VOLUME specifica l'ID dì volume del minidisco, del nastro o' del nastro a casset- 
ta. Si possono indicare da 1 a 6 caratteri alfanumerici. 


Nome membro specifica il nome del membro cartella da archiviare. Questo parame- 
tro è valido solo se il terzo parametro è MEMBER. 


Nome file specifica il nome del file che deve essere creato su minidisco, nastro o 
nastro a cassetta. Il nome può avere da 1 a 8 caratteri alfanumerici. Questo 
parametro è valido solo se deve essere archiviato un solo membro. Se il terzo 
parametro è MARKED, ciascun file archiviato ha lo stesso nome del membro 
archiviato. Se il terzo parametro è MEMBER e il nome file non è specificato, 
il file creato ha lo stesso nome del membro archiviato. 


S1,$2 0 $3 specifica l'alimentatore contenente il minidisco che riceve la copia del 
membro. Questo parametro è valido solo se il sesto parametro è {1. Se non 
si specifica alcun parametro, ed il sesto è 11, viene assunto S1. 


M1.nn o M2.nn specifica il caricatore contenente il primo minidisco che riceve la 
copia del membro. Questo parametro è valido solo se il sesto parametro è 11. 


AUTO specifica quanto segue: 

e SesonospecificatiS1, S20 S3, tutti e tre gli alimentatori possono essere uti- 
lizzati. L'elaborazione inizia dall’alimentatore specificato fino al terzo. Se ser- 
vono altri minidischi, un messaggio indica all'operatore di inserire gli altri mini- 
dischi. L'elaborazione riprende con il minidisco nell’alimentatore 1. 

e Sesono speficati M1.nn o M2.nn, entrambi i moduli a minidischi multipli pos- 
sono essere utilizzati. L'elaborazione inizia dal minidisco indicato e continua fi- 
no a quello in M2.10. Se servono altri minidischi, un messaggio indica all’ope- 
ratore di inserire gli altri caricatori. 

e Sesonospecificati T1 o T2, quando la bobina sulla unità nastro è finita, il siste- 
ma passa sull'altra unità nastro se disponibile, per continuare l'elaborazione (da 
T1aT20daT2a T1). Se l'altra unità nastro non è disponibile, viene usata 
sempre la stessa. Una richiesta viene emessa per verificare che la bobina mon- 
tata sia quella giusta. 

*  Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato dal momento 
che è disponibile soltanto l’unità nastro a cassetta. 


Se non si specificano parametri, viene assunto AUTO. 


NOAUTO specifica quanto segue: 

e Sesonospecificati S1, S2 o S3 solo l'alimentatore specificato viene utilizzato. 
Se servono altri minidischi, un messaggio indica all'operatore di inserire l’altro 
minidisco nell’alimentatore specificato. 

e Se sono specificati M1.nn o M2.nn solo il caricatore specificato viene utilizza- 
to. L'elaboratore inizia con il minidisco in una posizione e continua fino all’ulti- 
mo del caricatore. Se occorrono altri minidischi, un messaggio indica all’opera- 
tore di inserire il successivo caricatore al posto del primo. L'elaborazione rico- 
mincia dalla prima posizione del magazzino. 

Se vengono specificati T1 o T2 solo l'unità nastro specificata viene usata. 
Se è specificato TC, il parametro AUTO/NOAUTO viene ignorato dal momento 
che è disponibile soltanto l’unità nastro a cassetta. 


REWIND specifica che il nastro deve essere riavvolto dopo l'archiviazione del mem- 
bro. Questo parametro è valido solo se è specificato T1, T2 o TC. Se non si 
specifica alcun parametro, viene assunto REWIND. 


147.2 


147.3 


LEAVE specifica che il nastro deve essere lasciato così come è dopo che il membro 
è stato archiviato. La successiva operazione inizia da questa posizione. Que- 
| sto parametro è valido solo se viene specificato T1, T2 o TC. 


UNLOAD specifica che il nastro dovrà essere riavvolto e scaricato dopo l'archiviazione 
del membro. Questo parametro non è valido solo se si specifica 11. Se sono specifi- 
cati UNLOAD e TC, il nastro verrà riavvolto dopo l'elaborazione. 


| Esempio 


Questo esempio mostra come archiviare membri in una cartella denominata FLDR1 
con un periodo di conservazione di 60 giorni. 

Il nastro che conterrà il membro archiviato è sull'unità nastro 2 e l'ID di volume del 
nastro è VOL002. Dopo l'archiviazione il nastro sarà riavvolto e scaricato. 


ARCHIVE FLDRI,,,,60,T2,VOL002,,,,, UNLOAD 


ZA 














Pagina-lasciata intenzionalmente bianca . 
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PROCEDURA ASM 


La procedura ASM compila o assembla un programma origine o una sottoroutine 
Assembler. Il programma compilato deve essere quindi sottoposto all'edizione di 
moduli oggetto per produrre un programma eseguibile. 


Per ulteriori informazioni sulla programmazione Assembler, vedere il manuale 
Programming with Assembler. Vedere la Procedura OLINK per informazioni sul 


modo in cui eseguire l'edizione di moduli oggetto. 


nome membro origine, |libreria di immissione|,|libreria di emissione |, 
libreria corrente libreria di immissione 


MAC , | ampiezza file origine | , | ampiezza file macro |, 
NOMAC 30 45 


ampiezza file lavoro assembler | ,| ampiezza file lavoro? assembler| , 
10 36 i 


NO |, | LIST s| XREF s| OBJ , [macro Library] 
YES NOLIST NOXREF NOOBJ 





nome membro origine specifica il nome dei membro origine contenente il pro- 
gramma o la sottoroutine Assembler da compilare. 


libreria d'immissione specifica il nome delia libreria che contiene il membro ori- 
gine. Se questo parametro non viene specificato, si presume la libreria cor- 
rente. 


libreria d'emissione specifica il nome della libreria che conterrà il programma 
compilato (detto anche modulo oggetto). Il programma compilato è inserito 
nel membro di sottoroutine di libreria e deve essere sottoposto a edizione di 
moduli oggetto per poter essere eseguito. Se ia libreria non è specificata, si 
presume la libreria che contiene il membro origine. 
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MAC specifica che si deve usare il processore di macro istruzioni. Se il parametro 
non è specificato, si presume MAC. 


NOMAC specifica che non deve essere usato il processore di macro istruzioni. 


ampiezza file origine specifica il numero di blocchi da usare per il file $SOURCE 
usato dal compilatore, che può essere qualsiasi numero da 1 a 999. Se il pa- 
rametro non è specificato, si presumono 30 blocchi. 


ampiezza file macro specifica il numero di blocchi da usare per il file BASMINPT 
usato dal compilatore che può essere qualsiasi numero da 1 a 999. Se il 
parametro non è specificato, si presumono 45 blocchi. 


ampiezza file lavoro assembler specifica il numero di blocchi da usare per il file 
di lavoro $WORK usato dal compilatore e che può essere qualsiasi numero 
decimale da 1 a 999. Se il parametro non viene specificato, si presumono 
10 blocchi. 


ampiezza file lavoro2 assembler specifica il numero di blocchi da usare per il file 
di lavoro $WORK2 usato dal compilatore e che può essere qualsiasi numero 
decimale da 1 a 999. Se il parametro non viene specificato, si presumono 36 
blocchi. 


NO specifica che la procedura ASM non deve essere inserita nella coda lavori ma 
deve essere eseguita dall'unità video. Se non è specificato alcun parametro, si 
presume NO. 


YES specifica che la procedura ASM deve essere eseguita dalla coda lavori, 


LIST o NOLIST specifica l'opzione di lista da usare. Se non è specificato alcun 
parametro, viene usata l'opzione di lista indicata sulla specifica assembler 
OPTIONS. 


LIST specifica che la procedura ASM deve produrre una lista del compilatore. 


NOLIST specifica che la procedura ASM non deve produrre una lista del 
compilatore. Vengono stampati soltanti gli errori e le specifiche di controllo. 


XREF o NOXREF specifica l'opzione di riferimento incrociato da usare, Se non 
è specificato alcun parametro, viene usata l'opzione di lista indicata sulla spe- 
cifica OPTIONS dell’Assembler. 


XREF specifica che la procedura ASM deve produrre una lista di riferimenti 
incrociati del programma. 


NOXREF specifica che la procedura ASM non deve produrre una lista di ri- 
ferimenti incrociati. i 


OBJ o NOOBI specifica se la procedura ASM deve inserire il programma compi- 
lato nella libreria specificata. Se non viene specificato alcun parametro, viene 
usata l'opzione oggetto indicata sulla specifica assembler OPTIONS. 


OBJ specifica che la procedura ASM deve inserire il programma compilato 
nella libreria come membro di sottoroutine. 


NOOBI specifica che la procedura ASM non deve disporre ii programma 
compilato nella libreria. 
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macro library specifica la libreria che viene esaminata alla ricerca di macro istru- 
zioni assembler. Se questo parametro non viene specificato oppure se viene 
specificato #ASMLIB, verrà usato il normale ordine di ricerca (ricerca in 
#ASMLIB per primo, quindi in #LIBRARY). Se viene specificato #LIBRA- 
RY, viene per prima cosa effettuata la ricerca in #LIBRARY quindi in 
#ASMLIB. Se viene specificata una libreria dell'utente questa viene esamina- 
ta per prima, seguita da #ASMLIB e quindi da #LIBRARY. 


Esempio 


Questo esempio mostra come compilare un programma Assembler denominato 
PROGRAMI1. II membro origine è contenuto nella libreria corrente e il membro 
di sottoroutine deve essere inserito nella libreria corrente. inoltre deve essere 
generata una lista del compilatore e una lista di riferimento incrociato del pro- 
gramma. 


ASM PROGRAMI,,,,333s sLIST,XREF 


ATA 


PROCEDURA ASMLOAD 


La procedura ASMLOAD crea una libreria denominata #ASMLIB e vi copia il 
supporto Assembler dal minidisco. ASMLOAD copia ulteriore supporto nella 
libreria di sistema (#LIBRARY). La procedura ASMLOAD può copiare mini- 
dischi PID (Program Information Department) o minidischì creati dalla proce- 
dura ASMSAVE. Vedere la Procedura ASMSAVE per informazioni sul modo in 
cui salvare il supporto Assembler su minidisco. 


La procedura ASMLOAD potrebbe modificare il record di configurazione principale, 
col risultato che potrebbe non esserci un membro di configurazione corrisponden- 
te. Per modificare il membro di configurazione e per farlo corrispondere al record 
di configurazione principale, vedere il manuale Modifica della configurazione del si- 
stema. Occorre normalmente usare la procedura CNFIGSSP per aggiungere il sup- 
porto al sistema. È possibile usare la procedura ASMLOAD per ripristinare il supporto 
che era stato precedentemente aggiunto con la procedura ASMSAVE. 


| Se sul sistema non è in uso l'’Assembler, si deve usare la procedura TOLIBR per co- 
piare il file ASM su minidisco nella libreria # LIBRARY, prima di eseguire ASMLOAD. 
Se # LIBRARY era sul Sistema con l'Assembler e poi ricaricata prima dell’esecuzio- 
ne di ASMLOAD, non è necessario copiare il file ASM su minidisco con la procedu- 
ra TOLIBR. 


ASMLOAD s | SL ampiezza libreria| ,| ampiezza indirizzario 
82 280 DI 
$3 


Ml.nn 
M2.nn 





A1, A2, A3 0 AA indica la preferenza del disco; cioè l'unità disco che viene esa- 
minata per prima alla ricerca di spazio disponibile. Se non è disponibile suf- 
ficiente spazio su quell’unità, vengono esaminate le altre unità (se esistono) 
e #ASMLIB viene inserito sull'unità disco meno usata. Se non è specificata 
alcuna locazione ed il sistema ha più di un'unità disco, F#FASMLIB viene inse- 
rito sull'unità disco meno usata, 


A1 specifica che # ASMLIB deve essere inserito sul primo disco, se è disponi- 
bile spazio. 


A2 specifica che # ASMLIB deve essere inserito sul secondo disco, se è dispo- 
nibile spazio. 


A3 specifica che # ASMLIB deve essere inserito sul terzo disco, se è disponibi- 
le spazio. 


A4 specifica che # ASMLIB deve essere inserito sul quarto disco, se è disponi- 
bile spazio. 
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S1, S2 o S3 specifica l'alimentatore a minidischi contenente il primo minidisco 
da usare. Se non è specificata alcuna posizione di minidisco, si presume S1. 


M1.nn o M2.nn specifica la locazione di caricatore contenente il primo minidisco Ea 
da usare. M1 indica il primo caricatore, M2 indica il secondo. nn è un valore 


decimale da 01 a 10 che identifica la locazione del minidisco nel caricatore. 
M1 equivale a specificare M1.01; M2 equivale a specificare M2.01. 


Ampiezza libreria specifica l'ampiezza in blocchi di # ASMLIB. Un blocco contiene 
2560 byte. La massima dimensione è 6553 blocchi. La minima 180 blocchi. 
Se non si specifica alcun parametro, viene assunto 180 blocchi. 

Ampiezza indirizzario, specifica l'ampiezza, in settori dell’indirizzario di # ASMLIB. 


Il massimo è 1024 settori. Il minimo 55 settori. Un blocco contiene 10 settori. Se 
non viene specificato alcun parametro, viene assunto 55. 


Esempio 
Creazione di #ASMLIB sul disco e copia del supporto Assembler da minidisco. 


ASMLOAD 


PROCEDURA ASMSAVE 
La procedura ASMSAVE copia su minidisco il supporto Assembler. Viene copia- 
to il supporto Assembler dalle librerie #ASMLIB e #LIBRARY. E’ possibile usare 
la procedura ASMLOAD per caricare il supporto Assembler da minidisco. Il mi- 


nidisco destinato a contenere la copia salvata deve avere come ID di volume 
PPASM e deve essere posto sull’alimentatore minidisco S1. 


ASMSAVE 


La procedura ASMSAVE non ha parametri. 


Esempio 
Copia del supporto Assembler su minidisco. 


ASMSAVE 


PROCEDURA AUTO 


Questa procedura è supportata soltanto per compatibilità con il Sistema/34 IBM. 
La procedura da usare sul Sistema/36 è la Procedura AUTOC. 
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PROCEDURA AUTOC 


La procedura AUTOC compila un programma RPG Il che contiene specifiche di 
auto report. ° 


Per informazioni su auto report, vedere il manuale Programmazione BPG Il. 


AUTOC nome membro origine, |libreria membro origine) ,}|COMP , |PRINT $ 
libreria corrente NOCOMP! |NOPRINT 
CRT 


NOXREF|,{num. massimo terminali|,|NONEP|,|libreria di emissione 
XREF o NEP libreria membro origine 





SOURCE » [DEBUG | ampiezza programma) si NOHALT| , REPLACE s |LINK 3 
PSOURCE NODEBUG HALT NOREPLACE| |NOLINK 


NOSOURCE 


NOOBJECT |,|libreria sottoroutine ,| GEN , lampiezza file lavoro 
OBJECT libreria membro origine| |NOGEN| |40 


‘nome dizionario dati], NOMRO 
MRO 





nome membro origine specifica il nome del membro origine di libreria che con- 
tiene le specifiche di programma auto report. 


libreria membro origine specifica il nome della libreria che contiene il membro 
origine da compilare. Se questo parametro non viene specificato, si presume 
la libreria corrente. 


COMP specifica che il compilatore RPG deve essere eseguito come parte della 
funzione auto report. Se non viene specificato alcun parametro, si presume 
COMP. 


NOCOMP specifica che il compilatore RPG non deve essere eseguito come parte 
della funzione auto report. 


PRINT specifica che la lista di compilazione creata dalla procedura AUTOC deve 
essere stampata. Se non è specificato alcun parametro, viene presunto PRINT. 


NOPRINT specifica che non deve essere né stampata né visualizzata alcuna lista. 


CRT definisce che la lista di compilazione creata dalla procedura AUTOC deve 
essere visualizzata sull'unità video che sta eseguendo la procedura AUTOC. 


NOXREF specifica che la procedura AUTOC non deve produrre una lista di rife- 
rimenti incrociati del programma RPG Il. Se non viene immesso alcun para- 


metro, si presume NOXREF. 
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XREF specifica che deve essere prodotta una lista di riferimenti incrociati. 


numero massimo terminali specifica il numero massimo di unità video (dette an- 
che terminali richiedenti multipli o MRT), che possono usare il programma 
contemporaneamente. ll numero può essere uno qualsiasi compreso tra O e 
‘ 99. Se il parametro non viene immesso, si presume un valore 0. Un valore 0 
indica che il programma è un programma per terminale richiedente singolo 
{SRT); cioè ciascuna unità video che esegue il programma sta realmente ese- 
guendo la propria copia del programma. Un valore di 1 o più, indica che il 
programma è un programma per terminali richiedenti multipli (MRT). 


Per ulteriori informazioni sui programmi MRT, vedere il manuale Concepts 
and Programmer's Guide. 


NONEP specifica che il programma non è un programma sempre residente in me- 
moria. Se non viene immesso alcun parametro, si presume NONEP. 


NEP specifica che il programma è un programma sempre residente in memoria. 
Per ulteriori informazioni sui programmi sempre residenti in memoria vedere 
it parametro NEP sulla Specifica OCL ATTR. 


libreria d'emissione specifica il nome della libreria che deve contenere il program- 
ma compilato. Se questo parametro non viene specificato, si presume la libre- 
ria del membro origine. 


SOURCE, PSOURCE o NOSOURCE specifica l'opzione di stampa da usare invece 
dell'entrata nella colonna 11 della specifica di controllo nei programma ori- 
gine. Se non viene specificato alcun parametro, viene usata l’entrata nella co- 
lonna 11 della specifica di controllo, Vedere il manuale Programmazione 
RPG I per le informazioni stampate da ciascuna opzione. 


SOURCE specifica che la procedura AUTOC deve creare una lista completa 
del compilatore. 


PSOURCE specifica che la procedura AUTOC deve creare una lista parziale 
del compilatore, 


NOSOURCE specifica che la procedura AUTOC non deve creare alcuna lista 
di compilatore. 


DEBUG o NODEBUG specifica l'opzione di ricerca e correzione degli errori da 
usare invece dell'entrata nella colonna 15 nella specifica di controllo del pro- 
gramma origine. Se non viene specificato alcun parametro, viene usato il va- 
lore indicato nella colonna 15 della specifica di controllo. 


DEBUG specifica che deve essere effettuata l'operazione di ricerca e corre- 
zione degli errori nel programma origine. 


NODEBUG specifica che l'operazione di ricerca e correzione degli errori nel 
programma origine non deve essere effettuata. 


ampiezza programma specifica la dimensione del programma in K byte (un K by- 
te uguale a 1024 byte) da usare invece della dimensione del programma im- 
messa dalle colonne da 12 a 14 della specifica di controlio nel programma 
origine. La dimensione può essere un numero pari da 2 a 64. Se non viene 
specificata alcuna dimensione, viene usata quella indicata nelle colonne da 
12 a 14 della specifica di controllo. 


NOHALT specifica che il compilatore non deve interrompere e visualizzare un 
messaggio di errore se incontra una segnalazione o un errore che interrompe 
il programma. Se non viene specificato alcun parametro, si presume NOHALT. 


HALT specifica che deve essere visualizzato un messaggio di errore se nel pro- 
gramma s'incontra una segnalazione o un errore che pone termine al pro- 
gramma. 


REPLACE specifica che se viene creato un membro oggetto o un membro di 
sottoroutine e nella libreria di emissione esiste già un membro oggetto o un 
membro di sottoroutine con lo stesso nome del programma, il programma di 
recente compilato deve sostituire il membro oggetto o il membro di sotto- 
routine esistente (non viene visualizzato alcun messaggio indicante la sostitu- 
zione). Se non viene specificato alcun parametro, si presume REPLACE. 


NOREPLAC specifica che se viene creato un membro oggetto o un membro di 
sottoroutine ed esiste già nella libreria di emissione un membro oggetto o 
._ un membro di sottoroutine con lo stesso nome del programma, deve essere 
visualizzato un messaggio; è possibile quindi sostituire il membro o cancellare 

la procedura. 


LINK specifica che deve essere creato un membro oggetto. Questo parametro 
crea un programma che può essere eseguito, senza dover per prima cosa sot- 
toporre a edizione di modulo oggetto il programma usando ia procedura 
OLINK. Se non viene immesso alcun parametro, viene presunto LINK, 


NOLINK specifica che non deve essere creato alcun membro oggetto. 


NOOBJECT specifica che non deve essere creato un membro di sottoroutine. Se 
non viene specificato alcun parametro, si presume NOOBJECT. 


OBJECT specifica che deve essere creato un membro di sottoroutine. Questo 
membro deve essere sottoposto a edizione di moduio oggetto usando la pro- 
cedura OLINK oppure l'editore di moduli oggetto a sovrapposizione prima 
di poterlo eseguire. 


libreria sottoroutine specifica il nome della libreria che conitiene una o più sotto- 
routine Assembler da combinare con il programma che viene compilato. Se 
non viene specificato alcun parametro, si presume la libreria del membro ori- 
gine, 


GEN specifica che se il programma origine contiene un file CONSOLE, devono 
essere creati i tracciati video per quel file CONSOLE. Se non viene specifi- 
cato alcun parametro, si presume GEN. 


NOGEN specifica che non devono essere creati tracciati video per un file CON- 
SOLE. 


ampiezza file lavoro specifica la dimensione, in blocchi, dei file di lavoro AUTOC. 
Se non è specificata alcuna dimensione, si presumono 40 blocchi. 


nome dizionario specifica il dizionario dati che contiene la definizione file 


comunicazioni da usarsi con il programma compilato. 


MRO o NOMRO specifica se il compilatore è da usarsi con strutture overlay resi- 
denti in memoria. Se non viene specificato alcun parametro, viene assunto 
NOMRO. 


MRO specifica che il compilatore è da usarsi con strutture overlay residenti in memoria. 


NOMRO specifica che il compilatore non è da usarsi con strutture overiay residenti 
in memoria. 
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Esempio 


Questo esempio mostra come compilare un programma RPG Il denominato 
PAYROLL. Il programma origine si trova nella libreria corrente; il membro og- 
getto sottoposto a edizione di modulo oggetto e compilato, deve essere disposto 
nella libreria corrente. Devono essere generate una lista origine e una lista di ri- 
ferimenti incrociati e deve essere usata l'operazione di ricerca e correzione er- 
rori RPG. 


AUTOC PAYROLL,,,,XREF,,,,SOURCE,DEBUG 
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PROCEDURA BACKUP 


La procedura BACKUP è supportata soltanto per compatibilità con il Sistema/34 
IBM. Quella che deve essere usata sul Sistema/36 è la Procedura SA VELIBAR, 


PROCEDURA BASIC 


La procedura BASIC avvia una sessione BASIC. E' possibile immettere, modifi- 
care e salvare o rimuovere i programmi BASIC, procedure BASIC o altri dati; ese- 
guire programmi immediatamente ed eseguire procedure BASIC. Vedere il manua- 
le Programming with BASIC per ulteriori informazioni su BASIC. 


nome libreria s | ampiezza regione) ,, | mentro procedura |, 
libreria corrente 28 


[ none dizionario dati | 5 [as | 





x 


nome libreria specifica la libreria per la sessione BASIC. Se non è specificato il 
nome della libreria, si presume la libreria corrente. 


ampiezza regione specifica il numero K byte (1024 byte) di memoria da riservare 
per la sessione BASIC. L'entrata deve essere un numero pari da 28 a 64. Se 
non si immette alcun numero, si presumono 28 K byte. 


La terza posizione di parametro è riservata per la compatibilità con il BASIC del 
Sistema/34 IBM. 


membro procedura specifica il nome di un membro di procedura di libreria che 
contiene specifiche OCL da usare quando i programmi vengono eseguiti. 


Il membro di procedura deve essere nella libreria corrente oppure nella libre- 
ria di sistema (#LIBRARY). Il membro di procedura può contenere qual- 
siasi specifica OCL che può essere inserita tra le specifiche OCL LOAD e 
RUN. Vedere Capitolo 5, Specifiche OCL per la descrizione delle specifiche 
OCL. 


nome dizionario dati specifica il dizionario dati che deve essere utilizzato con la 
sessione BASIC. 


ANS specifica che i programmi BASIC sono eseguiti utilizzando l’AMERICAN 
NATIONAL STANDARD FOR MINIMAL BASIC, (ANS x 3.60 - 1978). Se non 


viene specificato ANS, i programmi BASIC vengono eseguiti secondo le regole 
del Sistema/36. 


Esempio 
Per avviare una sessione BASIC: 


BASIC 


156 


PROCEDURA BASICP 


La procedura BASICP esegue procedure BASIC che non contengono errori e sono 
= state salvate come membri origine di libreria. Per ulteriori informazioni su BASIC, 
vedere il manuale Programming with BASIC. 


BASICP nome membro origine, |nome libreria »| ampiezza regione |,, 
libreria corrente 20; 


[ membro procedure | s | sramvs | i [ pone dizionario dati | , [45] 





nome membro origine specifica il membro origine di libreria che contiene la pro- 
cedura BASIC da eseguire. 


nome libreria specifica la libreria che contiene il membro origine e deve essere la 
libreria corrente durante la sessione BASIC. Se non viene sperilicato un no- 
me di libreria, si presume la libreria corrente. 


ampiezza regione specifica il numero K byte (1024 byte) di memoria da riservare 
per la sessione BASIC. Questa entrata deve essere un numero pari da 28 a 
64. Se non si immette alcun numero, si presumono 28 K byte. 


La quarta posizione di parametro è riservata per la compatibilità con il BASIC 
= del Sistema/34 IBM. 


membro procedura specifica il nome di un membro di procedura di libreria che 
contiene specifiche OCL da usare quando i programmi vengono eseguiti. Il 
membro di procedura deve essere nella libreria corrente o nella libreria di si- 
stema (#LIBRARY). Il membro di fibreria può contenere qualsiasi specifica 
OCL che può essere inserita tra le specifiche OCL LOAD e RUN. Vedere 
Capitolo 5, Specifiche OCL per la descrizione delle specifiche OCL. 


STATUS stampa informazioni sulla sessione BASIC. 


nome dizionario dati specifica il dizionario dati che deve essere utilizzato con la 
sessione BASIC. 


ANS specifica che i programmi BASIC sono eseguiti utilizzando l’AMERICAN 
NATIONAL STANDARD FOR MINIMAL BASIC, (ANS x 3.60 - 1978). Se non 
viene specificato ANS, i programmi BASIC vengono eseguiti secondo le regole 

del Sistema/36. 


Esempio 


Questo esempio mostra come eseguire una procedura BASIC denominata 
BASPROC. La procedura è contenuta nella libreria corrente. 


BASIC BASPROC 
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PROCEDURA BASICR 


La procedura BASICR esegue programmi BASIC che non contengono errori e 
sono stati salvati come membri di sottoroutine di libreria, Per ulteriori informa- 
zioni su BASIC, vedere il manuale Programming with BASIC. 


BASICR nome membro sottoroutine, | nome libreria , | ampiezza regione | ,, 
libreria corrente 28 





| membro procedura | 5 | srazus ] ; [pone dizionario dati | ; [av ] 





nome membro sottoroutine specifica il membro di sottoroutine di libreria che 
contiene il programma BASIC da eseguire. 


nome libreria specifica la libreria che contiene il membro di sottoroutine e deve 
essere la libreria corrente durante la sessione BASIC. Se non viene specifi- 
cato un nome di libreria, si presume la libreria corrente. 


ampiezza regione specifica il numero K byte (1024 byte) di memoria da riser- 
vare per la sessione BASIC. Questa entrata deve essere un numero pari da 
28 a 64. Se non si immette alcun numero, si presumono 28 K byte. 


La quarta posizione di parametro è riservata per la compatibilità con il BASIC 
del Sistema/34 IBM. 


membro procedura specifica il nome di un membro di procedura di libreria che 
contiene specifiche OCL da usare quando i programmi vengono eseguiti. Il 
membro di procedura deve essere nella libreria corrente o nella libreria di 
sistema (#LIBRARY). Il membro di libreria può contenere qualsiasi specifi 
ca OCL che può essere inserita tra le specifiche OCL LOAD e RUN. Vedere 
Capitolo 5, Specifiche OCL per le descrizioni delle specifiche OCL. 


STATUS stampa informazioni sulla sessione BASIC. 


nome dizionario dati specifica il dizionario dati che deve essere utilizzato con la 
sessione BASIC. 


ANS specifica che i programmi BASIC sono eseguiti utilizzando l’AMERICAN 
NATIONAL STANDARD FOR MINIMAL BASIC, (ANS x 3.60 - 1978). Se non 
viene specificato ANS, i programmi BASIC vengono eseguiti secondo le regole 
del Sistema/36. 

Esempio 


Questo esempio mostra come eseguire un programma BASIC denominato 
BASPROG. Il programma è contenuto nella libreria corrente. 


BASICR BASPROG 
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PROCEDURA BASICS 


La procedura BASICS converte un membro origine di libreria che contiene un 
programma BASIC in un membro di sottoroutine di libreria. La procedura può 
stampare una lista del programma e indica qualsiasi errore di sintassi nel program- 
ma; ciò può essere di aiuto per convertire un programma da un altro sistema, Per 
ulteriori informazioni sul BASIC, vedere il manuale Programming with BASIC, 


BASICS nome membro sottoroutine, |nome libreria sottoroutine 
libreria corrente 





[REPLACE |, LIST| , | ampiezza regione), 


XREF| |28 


nome membro origine . | nome libreria origine 
nome membro sottoroutine nome libreria sottoroutine 











nome membro sottoroutine specifica il membro di sottoroutine detla libreria da 
creare. 


nome libreria sottoroutine specifica la libreria che deve contenere il membro di 
sottoroutine. Se non si immette un nome di libreria, si presume la libreria 
corrente. 


REPLACE specifica che se esiste un membro di sottoroutine nella libreria specifi- 
cata, il nuovo membro di sottoroutine deve sostituire il vecchio. Se non vie- 
ne immesso REPLACE ed esiste già il membro di sottoroutine, viene visua- 
lizzato un messaggio e l'operatore può sostituire il membro esistente o can- 
cellare la procedura BASICS. 


LIST specifica che i contenuti del membro origine di libreria devono essere stam- 


pati sulla stampatrice assegnata all'unità video, unitafiente con qualsiasi mes- 
saggio di errore di formato. 
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XREF specifica che devono essere stampati sulla stampatrice assegnata all'unità 
video i contenuti del membro origine di libreria ed una lista di riferimenti 
incrociati unitamente a qualsiasi messaggio di errore di formato. 


Nota: se non viene immesso LIST o XREF e il membro origine di libreria 
contiene errori, viene visualizzato un messaggio e l'operatore deve cancellare 
la procedura BASICS. 


ampiezza regione specifica il numero di K byte (1024 byte) di memoria da riser- 
vare per la sessione BASIC. Quest'entrata deve essere un numero pari com- 
preso fra 28 e 64. Se non viene specificata la dimensione delia regione, si 
presumono 28 K byte. 


nome membro origine specifica il membro origine di libreria contenente il pro- 
gramma da convertire con BASICS. Se non si immette il nome del membro 
origine, si presume il nome del membro di sottoroutine. 


nome libreria origine specifica la libreria contenente il membro origine da conver- 
tire. Se non si immette il nome di libreria origine, si presume il nome di li- 
breria che contiene la sottoroutine (se indicato) o la libreria corrente. 


Esempio 


Questo programma mostra come convertire in un membro di sottoroutine il pro- 
gramma BASIC contenuto nel membro origine denominato BASPROG. li mem- 
bro origine è nella libreria corrente e deve essere listato. Il membro di sottorou- 
tine così generato, deve essere inserito nella libreria corrente. 


BASICS BASPROG,,,LIST 


PROCEDURA BASLOAD 


La procedura BASLOAD crea una libreria denominata #BLLIB e copia il suppor- 
to BASIC dal minidisco in quella libreria BASLOAD copia ulteriore supporto 
nella libreria di sistema (#LIBRARY). BASLOAD può anche creare una libreria 
denominata #BLHPLIB destinata a contenere il supporto di testi esplicativi 
BASIC. La procedura BASLOAD può copiare minidischi PID (Program Informa- 
tion Department) o minidischi creati dalla procedura BASSAVE., Vedere ia Proce- 
dura BASSAVE per informazioni sul modo in cui salvare il supporto BASIC su 
minidisco, 


La procedura BASLOAD può cambiare il record di configurazione principale con il 
risultato che potrebbe non esserci un membro di configurazione corrispondente. Per 
modificare il membro di configurazione per farlo corrispondere al record di configu- 
razione principale, vedere il manuale Modifica della configurazione del sistema. Oc- 
corre normalmente usare la procedura CNFIGSSP per aggiungere supporto al sistema. 
È possibile usare la procedura BASLOAD per ripristinare il supporto che era stato 
precedentemente salvato con la procedura BASSAVE. 


BASLOAD 





A1, A2, A3 o AA indica la preferenza del disco; cioè l’unità disco che viene esa- 
minata per prima alla ricerca di spazio disponibile. Se non è disponibile suf- 
ficiente spazio su quell’unità, vengono esaminate le altre unità {se esistono) 
e #BLLIB e #BLHPLIB vengono inseriti sull'unità disco meno usata. Se non 
è specificata alcuna locazione ed il sistema ha più di un'unità disco, #BLLIB 
e #BLHLIB vengono inseriti sull'unità disco meno usata. 


A1 specifica che #BLLIB e # BLHPLIB devono essere inseriti sul primo disco, 
se è disponibile spazio. 


A2 specifica che #BLLIB e #BLHPLIB devono essere inseriti sul secondo di- 
sco, se è disponibile spazio. 


A3 specifica che #BLLIB e # BLHPLIB devono essere inseriti sul terzo disco, 
se è disponibile spazio. 


A4 specifica che #BLLIB e # BLHPLIB devono essere inseriti sul quarto disco, 
se è disponibile spazio. 
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Y o N specifica se deve essere caricato da minidisco il supporto di testi esplica- 
tivi BASIC. Se nòn viene specificato alcun parametro, viene fatta richiesta 
per il valore. 


Y specifica che il supporto deve essere caricato. Viene creata una libreria 
#BLHPLIB che contiene il supporto di testi esplicativi BASIC. 


N specifica che il supporto non deve essere caricato. 


S1, S2 o S3 specifica l'alimentatore a minidischi contenente il primo minidisco 
da usare. Se non è specificata una posizione di minidisco, sì presume S1. 


M1.nn o M2.nn specifica la locazione di caricatore contenente il primo minidi- 
sco da usare. M1 indica il primo caricatore e M2 indica il secondo. nn è 
un valore decimale da 01 a 10 che identifica la locazione del minidisco nel 
caricatore. Specificare M1 equivale a specificare M1.01; specificare M2 equi- 
vale a specificare M2.01. 


Esempio 


Creazione di #BLLIB e #BLHPLIB su disco e copia del supporto BASIC da mi- 
nidisco. 


BASLOAD ,,Y 


PROCEDURA BASSAVE 


La procedura BASSAVE copia il supporto BASIC su minidisco. Viene copiato 
il supporto BASIC dalle librerie #BLLIB, #BLHPLIB (se esiste) e #LIBRARY. 
E’ possibile usare la Procedura BASLOAD per caricare il supporto BASIC da mi- 
nidisco. Il minidisco destinato a contenere la copia salvata deve avere come ID 
di volume PPBASC e deve essere disposto nell’alimentatore S1. 


BASSAVI 





LI] 


La procedura BASSAVE non ha parametri. 


Esempio 
Copia del supporto BASIC su minidisco. 


BASSAVE 
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f 
| PROCEDURA BGUATTR 


| La procedura BGUATTR modifica i modelli o i colori da utilizzarsi con il BGU/36 {Bu- 


TS, siness Graphics Utilies). 


| Per maggiori informazioni su BGUATTR vedere il manuale Business Graphics 
Utilies/36. 


| | BGUATTR (is Î [nome librerie | 


FILLPAT | 





nella libreria indicata nel parametro nome libreria. ll BGU/36 fornisce le tonali- 
tà di colore da 1 a 9. 
| : Il colore O quello assunto automaticamente, non può essere modificato. 


| COLOR specifica i colori da modificare nel membro oggetto di libreria # BGUTABL 


| FILLPAT specifica i modelli da creare o modificare nel membro oggetto di libreria 
# BGFPRTN nella libreria indicata sul parametro nome libreria. 


modelli da modificare. Se non viene specificata alcuna libreria, viene assunta 


| nome libreria specifica il nome della libreria contenente lo schermo dei colori e dei 
quella in uso al momento, 


| Esempio 
| L'esempio che segue mostra come modificare i modelli nella libreria OWNLIB. 


| BGUATTR FILLPAT,OWNLIB. 
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su una stampatrice grafica, visualizza un diagramma su un video-grafico, o traccia TÀ 
un diagramma su un plotter. 
Per maggiori informazioni su BGUCHART vedere il manuale Business Graphics 
Utilities. 
Per modificare un diagramma: 
BGUCHART [pesicn] i [ome ciagramma] 7 [nome vera] s |l 
pagina # 
Per disegnare su un plotter o visualizzare un diagramma: 
BGUCHART PLOT | , [nome diagramma | ; [nome ibreria ; ALL 
VIEW pagina # 
Per stampare un diagramma su una stampatrice-grafica: 
BGUCHART PRINT, [nome diagramma] : [rome ipreria] , [ALL ; [prio] sl ; 
pagina # copie 
[noci | , | HOLD 
NOHOLD 
DESIGN specifica che dovrà essere creato o modificato un diagramma. Se il 
primo parametro non viene specificato, viene assunto DESIGN. 
PLOT specifica che un diagramma dovrà essere inviato ad un plotter collegato 
al terminale video richiedente. Se il terminale video richiedente non è una 
unità supportata dal BGU/36 con un plotter collegato e acceso, viene in- 
viato un messaggio d'errore. 
PRINT specifica che il diagramma dovrà essere stampato su una stampatrice 
grafica supportata dal BGU/36. 
VIEW specifica che il diagramma dovrà essere visualizzato su un terminale video- 
grafico supportato dal BGU/36. Se il terminale video richiedente non è gra- 
fico, viene inviato un messaggio di errore e il programma termina. 
nome-diagramma specifica il nome del membro del diagramma. Se non è spe- SPS 
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| PROCEDURA BGUCHART 





La procedura BGUCHART crea o modifica un diagramma, stampa un diagramma 








cificato, viene visualizzata la lista scelta membri. 


sr 


nome libreria specifica il nome della libreria contenente il membro diagramma 
indicato nel parametro 2. Se non specificato, viene usata la libreria in uso. 


| ALL specifica che tutte le pagine dei diagrammi definite in un membro diagram- 

° ma sono di stampare, visualizzare o tracciare su un plotter. Se non viene 
specificato, e sul primo parametro è indicato PLOT, PRINT, o VIEW, viene 
assunto ALL. 


Pagina # specifica il numero pagina del diagramma da stampare, visualizzare 
o tracciare. Se sul primo parametro è indicato DESIGN, pagina # indica 
la prima pagina da cui iniziare la sessione di edizione. Se questo parame- 
tro non viene specificato e DESIGN è indicato sul primo parametro, viene 
assunto 1. Se questo parametro non viene specificato e PLOT, PRINT o 
VIEW è indicato sul primo parametro, viene assunto ALL. 


to, viene usata la stampatrice di sessione. Questo parametro è valido solo 
se è indicato PRINT. 


copie specifica il numero di copie del diagramma che deve essere stampato. 
Se non specificato, viene assunto 1 copia. Questo parametro è valido so- 
lo se è indicato PRINT. 


moduli # specifica il numero dei moduli da usarsi per la stampa. Se non speci- 
ficato, viene utilizzato il numero moduli di sessione assunto automatica- 
mente dalla stazione video richiedente. Questo parametro è valido solo se 
è indicato PRINT. 


HOLD specifica che il file di stampa diagrammi deve essere congelato nel file 
stampa differita dopo che tutte le copie sono state stampate. Se non spe- 
cificato, viene assunto NOHOLD. Questo parametro è Valido solo se è in- 
dicato PRINT. 


NOHOLD specifica che il file di stampa diagrammi non deve essere congelato 
nel file di stampa differita dopo la stampa di tutte le copie. Questo para- 


| ID stampatrice specifica l'ID della stampatrice di emissione. Se non specifica- 
| metro è valido solo se è indicato PRINT. 


| Esempio 1 
| Questo esempio mostra come creare o aggiornare un diagramma denominato PRO- 
JET nella libreria OWNLIB. 


I BGUCHART,PROJECT,OWNLIB 
| Esempio 2 


| Questo esempio mostra come tracciare su un plotter grafici definiti su pagina 5 di 
un membro diagramma denominato PROJECT della libreria OWNLIB. 


| BGUCHART PLOT, PROJECT,OWNLIB,5 
| Esempio 3 


diagramma denominato PROJECT della libreria OWNLIB, su.un video a capacità 


Questo esempio mostra come visualizzare grafici definiti su pagina 1 di un membro 
grafica.. 


| BGUCHART VIEW,PROJECT,OWNLIB,1 
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| Esempio 4 


Questo esempio mostra come stampare tutti i grafici definiti in un diagramma de- 
nominato PROJECT della libreria OWNLIB su una stampatrice a capacità grafica. 
Due copie dovranno essere stampate ed il file diagramma dovrà essere congelato 
nel file stampa differita dopo la stampa delle due copie. 


| BGUCHART PRINT,PROJECT,OWNLIB,P2,2,,HOLD 


| PROCEDURA BGUDATA 


La procedura BGUDATA copia un file di immissione grafico generato dall'utente 
(GDIF) su un membro dati e memorizza tale membro nella libreria specificata nel 
parametro nome libreria. 

I Per maggiori informazioni vedere il manuale Business Graphics Utilities/36. 


| La procedura BGUDATA può essere eseguita scegliendo l'opzione appropriata sui 
menu BGU/36 o eseguendo la procedura che segue: 


BGUDATA [srircorr| : [nome fel , | nome file 


nome membro dati grafici 


[nome librerie] ; [rePLACE] 





GDIFCOPY specifica che un file di immissione grafico generato dall'utente (GDIF) 
deve essere copiato su un membro dati memorizzato nella libreria utente in uso. 
Se il primo parametro non viene specificato, viene assunto GDIFCOPY. 


nome file specifica il nome del file di immissione grafico da copiare su un membro 
dati grafici. Se il nome file non è specificato, o se il nonfe specificato non è 
trovato, viene inviato un messaggio di errore e la procedura ha termine. 


nome membro dati grafici specifica il nome del membro dati grafici creato da BGU- 
DATA. Se non specificato, il nome specificato nel secondo parametro è utiliz- 
zato come nome membro dati grafici. 


procedura BGUDATA. Se non specificato, viene utilizzata la libreria in uso 
corrente. 


REPLACE specifica che se il membro di libreria già esiste con il nome specificato, 
deve essere sostituito. Se è specificato REPLACE, il nuovo membro sostitui- 
sce quello esistente con il nome duplicato, e nessun messaggio viene inviato 
per indicare l'avvenuta sostituzione. 


Se non è specificato REPLACE, il membro è posto nella libreria, se non viene 
trovato un nome uguale, altrimenti il Sistema visualizza un messaggio indican- 
te che esiste un nome duplicato. In risposta al messaggio, l'operatore può can- 
cellare il lavoro o continuare l'elaborazione. Se si continua con l'elaborazione, 


| nome libreria specifica il nome della libreria che contiene il membro dati creato dalla 
il nuovo membro sostituisce il vecchio membro nella libreria. 


| Esempio 
‘Questo esempio mostra come copiare il file PAYROLL in un membro denominato 
PAYROLL (per valore assunto) nella libreria PAYLIB. Se il membro PAYROLL esiste, 
verrà sostituito. 


| BGUDATA GDIFCOPY,PAYROLL,,PAYLIB, REPLACE 
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| PROCEDURA BGUGRAPH 


‘ La procedura BGUGRAPH crea o aggiorna un grafico, stampa un grafico su una stam- 












patrice a capacità grafica, visualizza un grafico su una stazione video a capacità di 
grafica, traccia un grafico su un plotter, o crea una versione file oggetto grafico di 
un grafico. 
| Per maggiori informazioni sulla procedura BGUGRAPH, vedere il manuale Business 
Graphics Utilities/36. 
| Per creare un file oggetto grafico di un grafico: 
| BGUGRAPH BLDFILE, [nome membro formato grafico] ; [pome membro dati grafici ; 
I [nome libreria , j nome file oggetto grafico 
| nome membro formato grafico 
| Per disegnare un grafico, inviarlo su un plotter, o visualizzarlo su una stazione video 
a capacità grafica: 
| BGUGRAPH DESIGN|, [nome membro formato grafico | i [nome membro dati grafici : 
| PLOT = 


VIEW 






ome ever 






| Per stampare un grafico su una stampatrice a capacità grafica: 
BGUGRAPH PRINT, [rome membro formato grafico] i [pome membro dati greta ; 


[nome libreria] i [pet ; |l è [moduli i ; | HOLD 
copie NOHOLD 
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BLDFILE specifica che deve essere creato un file oggetto grafico. 


DESIGN specifica che dovrà essere creato o modificato un grafico. Se il primo para- 
metro non viene specificato, viene assunto DESIGN. 


PLOT specifica che un grafico dovrà essere inviato ad un plotter collegato al termi- 
nale video richiedente. Se il terminale video richiedente non è una unità sup- 
portata dal BGU/36 con un plotter collegato e acceso, viene inviato un mes- 
saggio d'errore. 


PRINT specifica che il grafico dovrà essere stampato su una stampatrice grafica sup- 
portata dal BGU/36. 


VIEW specifica che il grafico dovrà essere visualizzato su un terminale video-grafico 
supportato dal BGU/36. Se il terminale video richiedente non è grafico, viene 
inviato un messaggio di errore e ii programma termina. 


nome membro formato grafico specifica il nome dei membro da utilizzare per gene- 
rare il grafico. Se non specificato, viene visualizzata la lista di scelta membri. 


nome membro dati grafici specifica il nome membro dati grafici da utilizzare per ge- 
nerare il grafico. Se non viene specificato viene utilizzato quello indicato dal 
membro formato grafico. Se il membro non si trova nella libreria, viene indica- 
to un messaggio d'errore. 


nome libreria specifica il nome della libreria contenente i membri grafici specificati 
dal nome membro formato grafico e dal nome membro dati grafici. Se non spe- 
cificato, viene utilizzata ia libreria in uso corrente. 


nome file oggetto grafico specifica il nome da assegnare al file creato. Se non spe- 
cificato, al file viene assegnato lo stesso nome del nome membro formato gra- 


fico. Questo parametro è valido solo se è specificaté BDLFILE nel primo 
parametro. 


ID stampatrice specifica l'ID della stampatrice di emissione. Se non specificato, viene 
usata la stampatrice di sessione. Questo parametro è valido solo se è indicato 
PRINT. 


copie specifica il numero di copie del grafico che deve essere stampato. Se non spe- 
cificato, viene assunto 1 copia. Questo parametro è valido solo se è indicato 
PRINT. 


moduli # specifica il numero dei moduli da usarsi per la stampa. Se non specifica- 
to, viene utilizzato il numero moduli di sessione assunto automaticamente dal- 
la stazione video richiedente. Questo parametro è valido solo se è indicato 
PRINT. 


HOLD specifica che il file di stampa grafici deve essere congelato nel file stampa 
differita dopo che tutte le copie sono state stampate. Se non specificato, vie- 
ne assunto NOHOLD. Questo parametro è valido solo se è indicato PRINT. 


NOHOLD specifica che il file di stampa grafici non deve essere congelato nel file 
di stampa differita dopo la stampa di tutte le copie. Questo parametro è valido 
solo se è indicato PRINT. 
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Esempio 1 


Questo esempio mostra come creare un file oggetto grafico del grafico STAT nella 
libreria MYLIB. II file oggetto grafico verrà denominato STATFILE e STAT è il nome 


del membro formato grafico. 


BGUGRAPH BLDFILE,STAT,,MYLIB,STATFILE 


Esempio 2 


Questo esempio mostra come disegnare un nuovo grafico nella libreria MYLIB. Il 
nome membro formato grafico sarà STAT e il nome membro dati grafici STATNUM. 


BGUGRAPH DESIGN, STAT,STATNUM,MYLIB 


Esempio 3 


Questo esempio mostra come inviare su un plotter un grafico denominato STAT. 
Il nome membro formato grafico è STAT, il nomé membro dati grafici sarà quetlo 
assunto automaticamente. ll grafico sarà nella libreria denominata MYLIB. 


BGUGRAPH PLOT,STAT, MYLIB 


Esempio 4 


Questo esempio mostra come stampare un grafico denominato STAT nella libreria 
MYLIB. Il membro formato grafico è denominato STAT e il membro dati grafici sarà 
quello assunto automaticamente. L'ID della stampatrice a capacità grafica è P2. Ver- 
ranno stampate 3 copie sul numero modulo 7654 e il file di stampa grafica verrà 
congelato nel file di stampa differita dopo la stampa delle 3 copie. 


BGUGRAPH PRINT,STAT,,MYLIB,P2,3,7654,HOLD 


Esempio 5 


Questo esempio mostra come visualizzare un grafico denominato STAT su una sta- 
zione video a capacità grafica. II nome membro formato grafico è STAT, il nome 
membro dati grafici sarà quello assunto automaticamente, la libreria è MYLIB. 


BGUGRAPH VIEW,STAT,,MYLIB 


| PROCEDURA BGULOAD 


La procedura BGULOAD crea una libreria denominata #BGULIB e vi copia il sup- 
porto BGU/36 (Business Graphics Utilities) dal minidisco. BGULOAD copia il sup- 
porto addizionale nella libreria di Sistema (# LIBRARY). Il supporto BGU/36 è cari- 
cato nella libreria # BGUHLIB. La procedura BGULOAD può copiare sia i minidischi 
.ricevuti dal Centro Distribuzione IBM che quelli creati dalla procedura BGUSAVE. 


col risultato che potrebbe non esserci un membro di configurazione corrisponden- 
te. Per modificare il membro di configurazione e per farlo corrispondere al record di 
configurazione principale, vedere il manuale Modifica della configurazione del siste- 
ma. Occorre normalmente usare la procedura CNFIGSSP per aggiungere il supporto 
al sistema. È possibile usare la procedura BGULOAD per ripristinare il supporto che 
era stato precedentemente aggiunto con la procedura ASMSAVE. 


Se il BGU/36 non è in uso sul sistema, prima di eseguire la procedura BGULOAD, 
si deve utilizzare la procedura TOLIBR per copiare il file BGU dal minidisco alla libre- 
ria # LIBRARY. 


Se # LIBRARY era sul Sistema con il BGU/36 e poi ricaricata prima dell'esecuzione 
di BGULOAD, non è necessario copiare il file BGU che è sul minidisco con la proce- 


La procedura BGULOAD potrebbe modificare il record di configurazione principale, 
| dura TOLIBR. 


BGULOAD 





A1, A2, A3 o A4 indica la preferenza del disco; cioè l'unità disco che viene esami- 
nata per prima alla ricerca di spazio disponibile. Se non è disponibile sufficien- 
te spazio su quell’unità, vengono esaminate le altre unità (se esistono) e # BGU- 
LIB viene inserito sull'unità disco meno usata. Se non è specificata alcuna lo- 
cazione ed il sistema ha più di una unità disco, #BGULIB viene inserito sull’u- 
nità disco meno usata. 


A1 specifica che # BGULIB deve essre inserito sul primo disco, se è disponibile 
spazio. 


A2 specifica che # BGULIB deve essere inserito sul secondo disco, se è disponibile 
spazio. 


spazio. 


A4 specifica che # BGULIB deve essere inserito sul quarto disco, se è disponibile 
spazio. 


S1, $S2,0 $3 specifica l'alimentatore a minidischi contenente il primo minidisco da 
usare. Se non è specificata alcuna posizione di minidisco, si presume S1. 


M1.nn o M2.nn specifica la locazione di caricatore contenente il primo minidisco 
da usare. M1 indica il primo caricatore, M2 indica il secondo. nn è un valore 
decimale da 01 a 10 che identifica la locazione del minidisco nel caricatore. 


| A3 specifica che # BGULIB deve essere inserito sul terzo disco, se è disponibile 
| M1 equivale a specificare M1.01; M2 equivale a specificare M2.01. 
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Yo N specifica se si deve caricare il supporto di ausilio BGU/36 nella libreria #BGUH- 
LIB. Se non specificato, viene fatta richiesta per il valore da immettere. Se nul- 
la tranne N, è specificato, viene assunto Y. 


| N specifica che il supporto non deve essere caricato. 
| _ Y specifica che il supporto deve essere caricato. 
| Esempio 


| Creazione di #BGULIB su disco e copia del supporto BGU da minidisco. 


| BGULOAD 


| PROCEDURA BGUSAVE 


La procedura BGUSAVE copia su minidisco il supporto BGU/36 (Business Graphics 
Utilities). Il BGU/36 viene copiato dalle librerie # LIBRARY, #BGULIB e # BGUH- 
LIB. È possibile usare la procedura BGULOAD per caricare il supporto BGU da mini- 
dischi di riserva. Il minidisco che dovrà contenere la copia salvata deve avere come 
ID di volume PPBG1. 


BGUSAVE 
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| La procedura BGUSAVE non ha parametri. 


| Esempio 
| Copia del supporto BGU/36 da #LIBRARY e #BGULIB su minidisco. 


| BGUSAVE 


BLDFILE 


PROCEDURA BLDFILE 


nome 





La procedura BLDFILE crea un file su disco che non contiene dati. AI file si può quindi 
fare riferimento da parte dei lavori e dei passi di lavoro successivi come a un file 
esistente nel quale essi possono inserire dati. La procedura BLDFILE può essere uti- 
lizzata per creare un file su un sistema remoto. 


La procedura BLDFILE esegue il programma di utilità $FBLD. 


BLOCKS |, ampiezza, lunghezza record, | Al 
(B) AQ 
RECORDS AZ 
(R) Ah 


numero blocco 





» { posizione chiave,j,| NDFILE|,|NODUPKEY| ,| valore estensione 
lunghezza chiave DFILE DUPKEY O 





bi 


nome file specifica il file da creare. Un nomè file può contenere fino a 8 carat- 
teri e deve iniziare con un carattere alfabetico (da A a Z, #, @ o $). | ca- 
ratteri rimanenti possono essere qualsiasi combinazione di caratteri (nume- 
rici, alfabetici e speciali) salvo le virgole (,), gli apici (’) e gli spazi vuoti. 
Non utilizzare il nome di file ALL. 


S specifica che deve essere creato un file su disco sequenziale. 
I specifica che deve essere creato un file su disco a indice, 
D specifica che deve essere creato un file su disco diretto. 


BLOCKS o B specifica che lo spazio per il file deve essere allocato (o riservato) 
mediante blocchi. 


RECORDS o R specifica che lo spazio per il file deve essere allocato (o riservato) 
mediante record. 


ampiezza specifica la dimensione del file da creare. Se viene specificato BLOCKS 
o B, la dimensione del file può essere da 1 al numero massimo di blocchi di 
memoria disco configurati sul sistema. Se viene specificato RECORDS o R, la 
dimensione del file può essere da 1 a 8.000.000 di record. ll numero non può 
essere maggiore del numero di blocchi inutilizzati o record disponibili per i file 
dell'utente. È possibile usare la procedura CATALOG per determinare la quan- 
tità di spazio disponibile per il file. 


lunghezza record specifica la lunghezza del record in byte e può essere qualsiasi 
numero decimale da 1 a 4,096, Un byte contiene un carattere di dati. 
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A1, A2, A3 o AA indica la preferenza del disco; cioè l'unità disco che viene esa- 


minata per prima alla ricerca di spazio disponibile. Se non è disponibile suf- 
ficiente spazio su quell’unità, vengono esaminate le altre unità (se esistono) 
ed il file viene inserito sull'unità disco meno usata. Se non è specificata 
alcuna locazione ed il sistema ha più di un'unità disco, il file viene inserito 


sull'unità disco meno usata. 


A1 specifica che la locazione preferenziale del file su disco è sul primo disco, 
se è disponibile spazio. ‘ 


A2 specifica che la locazione preferenziale del file su disco è sul secondo di- 
sco, se è disponibile spazio. 


A3 specifica che la locazione preferenziale del file su disco è sul terzo disco, 
se è disponibile spazio. 


A4 specifica che la locazione preferenziale del file su disco è sul quarto disco, 
se è disponibile spazio. 


numero blocco specifica la locazione dei primo blocco nel file. E’ possibile speci- 


ficare fino a 6 cifre. E’ possibile usare la procedura CATALOG per determi- 
nare dove sono disponibili biocchi di spazio su disco. Usare il parametro del 
numero di biocco con cautela in quanto le procedure COMPRESS e 
RESTORE, possono provocare lo spostamento di un file dal numero di 
blocco specificato al momento della creazione del file. 


Vedere la Specifica OGL FILE (per file su disco) per ulteriori informazioni 
sulla locazione del file per numero di blocco. 


T.,5 o $S specifica il tipo di ritenzione del file su disco. Se non è specificata la 


ritenzione del file, si presume T. 

T specifica che il file è un file residente, 

J specifica che il file è un file lavoro. 

S specifica che il file è un file temporaneo. 


Nota: per informazioni sui tipi di ritenzione dei file, vedere la Specifica OCL 
FILE [per i file su disco). 


posizione chiave specifica la posizione iniziale dell’area della chiave nell'ambito 


del record e deve essere uh numero compreso fra 1 a 4.096, La posizione 
della chiave è richiesta se viene creato un file a indice (viene specificato | per 
il parametro 2). Se è specificata una posizione di chiave ma non viene creato 
un file a indice, viene visualizzato un messaggio di errore. L'intera chiave, de- 
finita per posizione e lunghezza di chiave, deve essere nell'ambito del record. 


lunghezza chiave specifica la lunghezza dell’area della chiave nell’ambito del record 


e deve essere un numero da 1 a 120. La lunghezza della chiave è richiesta se 
viene creato un file a indice (viene specificato | per il parametro 2). Se viene 
specificata una lunghezza di chiave ma non viene creato un file a indice, viene 
visualizzato un messaggio di errore. L'intera chiave, definita per posizione e lun- 
ghezza di chiave, deve essere all’interno del record. 


DFILE specifica che il file deve essere un file in cui è consentita la cancellazio- 
ne di record. 


x . 


Nota: la cancellazione di un record da un file in cui è possibile tale cancella- 
zione non provoca la rimozione del record. Per contro, il record è contrasse- 
gnato come cancellato (viene inserito un esadecimale FF nella prima posizio- 


ne del record). 


NDFILE specifica che il file non è un file dal quale è possibile cancellare i re- 
cord. Se questo parametro non è specificato, si presume NDFILE. 


DUPKEY specifica che nel file a indice che viene creato sono ammesse chiavi 
doppie. Se il file che viene creato non è un file a indice, questo parametro 
viene ignorato. 


NODUPKEY specifica che le chiavi doppie non sono ammesse nel file a indice 

che viene creato. Se questo parametro non viene specificato, si presume 

“ NODUPKEY. Se il file che viene creato non è un file a indice, questo para- 
metro è ignorato. 


valore estensione specifica il valore di cuì un file può essere esteso ogni volta che 
nel file occorre spazio addizionale. Il valore specificato è il numero di record 
(se il file è allocato in record) o di blocchi (se il file è allocato in blocchi), di 
cui il file può essere esteso. 


Il numero non può superare 8.000.000 record o 312.815 blocchi. Se non 
viene specificato alcun valore o se viene specificato 0, il file che viene creato 
non può essere esteso; non sarà cioè automaticamente esteso ogni volta che 
occorre spazio addizionale. 


Esempio 1 


Creazione di un file residente in cui è possibile cancellare i record, ampio 13 
blocchi. Il file è INVOICE, la lunghezza record è 50 byte, il posizionamento pre- 
ferito del file è sul primo disco e ciascun record contiene una chiave di 4 byte 
che inizia alla posizione 9 nel record. 


BLDFILE INVOICE,I,BLOCKS,13,50,A1,T,9,4,DFILE 


Esempio 2 


Per creare un file di lavoro denominato JOB per la procedura PAYROLL, occorre 
procedere come segue. Il file deve essere sequenziale, avere una dimensione di 10 
blocchi e avere una lunghezza record di 100. 


* Creazione di un file di lavoro 

BLDFILE J0OB,S,BLOCK,10,100,,J 

* Esecuzione della procedura payroll 
- PAYROLL 
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PROCEDURA BLDINDEX 


La procedura BLDINDEX crea un file residente che contiene l'indice alternativo per 
un file fisico. Il file fisico deve essere un file residente, a indice, o sequenziale. Se 
il file fisico è un file ad accesso diretto, questo deve essere cancellabile. La proce- 
dura BLDINDEX può essere usata per creare un file a indice alternativo su un siste- 
ma remoto specificando l’identificazione del file locale come se fosse definito nel- 
l'indirizzario risorse di rete del sistema (NRD). Anche il file fisico deve essere defini- 
to nell'NRD, e le entrate dei due file devono indicare che essi sono sulla stessa ubi- 
cazione remota. Vedere il manuale Concepts and Programmer's Guide per ulteriori 
informazioni sugli indici alternativi. 


Un file a indice alternativo può essere considerato come un file identico al file fisico 
originale ma in cui la chiave è definita differentemente. Notare che il file fisico non 
è copiato; le chiavi nel file a indice alternativo prevedono un modo diverso di acces- 
so ai record nel file fisico. 


La procedura BLDINDEX esegue il programma di utilità $FBLD. 


BLDINDEX nome file ad indice alternativo,posizione chiave,lunghezza chiave, 


ggmmaa NODUPKEY A2 
aammgg A3 
A 
numero blocco 


nome file fisico, | mnggaa |, oTor | » | Al 


: | posizione chiave2,lunghezza chiave2 |,[ posizione chiave3, lunghezza chiaves | 





nome file ad indice alternativo specifica il nuovo file che conterrà l’indice alter- 
nativo per il file fisico. 


posizione chiave specifica la posizione iniziale dell’area della chiave nell'ambito 
del record per l'indice alternativo. La posizione deve essere un numero da 1 
a 4.096. L'intera chiave, definita dalla posizione e dalla lunghezza di chiave, 
deve essere entro il record. 


lunghezza chiave specifica la lunghezza dell’area della chiave, o quella del primo 
campo per l'indice alternativo. La chiave può comprendere una singola area 
nel record o essere divisa in due o tre campi. La lunghezza totale di tutti i cam- 
pi della chiave non può superare 120 caratteri. 


nome file fisico specifica il file fisico per il quale viene creato l'indice alternativo. 
Il file fisico deve essere un file a indice residente. 


mmggaa, ggmmaa o aammgg specifica la data in cui il file fisico è stato creato. La 
data, se specificata, deve essere nel formato della data di sessione; usare il 
comando STATUS SESSION per determinare il formato delia data di sessio- 
ne. Se questo parametro non è specificato ed esiste più di un file con lo stes- 
so nome, viene usato il file più recente. 


DUPKEY specifica che nel file a indice alternativo sono ammesse chiavi a indice 
doppie. Se non viene immesso alcun parametro, si presume DUPKEY. 


NODUPKEY specifica che le chiavi a indice doppie non sono ammesse nel file a 
indice alternativo. 
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A1, A2, A3 0 A4 indica la preferenza del disco; cioè l'unità disco che viene esa- 
minata per prima alla ricerca di spazio disponibile. Se non è disponibile suf- 
ficiente spazio su quell’unità, vengono esaminate le altre unità (se esistono) 
ed il file viene. inserito sull'unità disco meno usata. Se non è specificata 
alcuna locazione ed il sistema ha più di un'unità disco, il file viene inserito 
sull'unità disco meno usata. 


A1 specifica che la locazione preferenziale del file su disco è sul primo disco. 
Se è disponibile spazio, l'SSP inserisce il file sul primo disco. 


A2 specifica che la locazione preferenziale del file su disco è sul secondo di- 
sco. Se è disponibile spazio, l'SSP inserisce il file sul secondo disco. 


A3 specifica che la locazione preferenziale del file su disco è sul terzo disco. 
Se è disponibile spazio, il sistema inserisce il file sul terzo disco. 


A4 specifica che la locazione preferenziale del file su disco è sul quarto disco. 
Se è disponibile spazio, il sistema inserisce il file sul quarto disco. 


numero blocco specifica la locazione del primo blocco nel file. E’ possibile speci 
ficare fino a 6 cifre. E’ possibile usare la procedura CATALOG per determi 
nare dove sono disponibili sul disco blocchi di spazio. Usare il parametro del 
numero di blocco con cautela, in quanto le procedure COMPRESS e RESTO: 
RE possono provocare lo spostamento di un file dal numero di blocco speci 
ficato al momento della creazione del file. Vedere la Specifica OCL FILE 
{per i file su disco) per ulteriori informazioni sull’individuazione di un file 
per numero di blocco, 


posizione chiave 2 specifica, per un indice alternativo, la posizione iniziale del 
secondo campo nella chiave. Può essere un numero da 1 a 4096. Un campo 
chiave non può sovrapporsi ad un altro campo chiave. Se nén specificato, nes- 
sun valore può essere specificato per il terzo campo chiave o terza lunghezza 
e la chiave deve occupare un'unica area nel record. 


lunghezza chiave 2 specifica, per un indice alternativo, la lunghezza del secondo 
campo nella chiave. La lunghezza totale dei campi che compongono la chiave 
non può superare 120 byte. Un campo chiave non può sovrapporsi ad un altro 
campo chiave. Se non specificato, nessun valore può essere indicato per il ter- 
zo campo chiave o terza lunghezza e la chiave deve occupare un'unica area 
nel record. 


posizione chiave 3, specifica, per un indice alternativo, la posizione iniziale del terzo 
campo nella chiave. Può essere un numero da 1 a 40986. Un campo chiave non 
può sovrapporsi ad un altro campo chiave. Se non specificato, significa che la 
chiave occupa una sola area nel record, 0 è formata dai campi specificati dalle 
prime due posizioni chiave. 


lunghezza chiave 3 specifica, per un indice alternativo, la lunghezza del terzo cam- 
po nella chiave. La lunghezza totale dei campi che compongono la chiave non 
può superare 120 byte. Un campo chiave non può sovrapporsi ad altro campo 
chiave. Se non specificato, significa che la chiave occupa una singola area sul 
record o è formata dai campi specificati con le prime due posizioni chiave. 
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Esempio 1 


Questo esempio mostra come creare un file a indice alternativo da un file a indi- 
ce fisico denominato CUSTOMER. ll file CUSTOMER è contrassegnato da chiave 
su numero cliente nelle posizioni da 1 a 4 del record. Il file a indice alternativo 
deve essere contrassegnato da chiave per nome di cliente, che è nelle posizioni da 
5 a 20 del record (una lunghezza di chiave di 16), deve essere denominato CUST- 
NAME e deve avere una locazione preferita di A2. 


BLDINDEX CUSTNAME,5,16,CUSTOMER,,,A2 


Esempio 2 


Questo esempio mostra come creare un file a indice alternativo da un file fisico de- 
nominato EMPLOYEE con una chiave formata da due campi. il file EMPLOYEE è un 
file ad accesso diretto con cancellazione record consentita. L'indice alternativo de- 
ve essere contrassegnato da chiave per numero reparto, in posizione 40 - 44 del 
record (lunghezza chiave 5) e numero impiegato, in posizione 1 - 8 del record. 
(lunghezza chiave 8). Il file a indice alternativo deve essere denominato EMPLDEPT, 
e avere locazione sull'ultima unità disco utilizzata. 


BLDINDEX EMPLDEPT,40,5,EMPLOYEE,,,,1,8. 


Esempio 3 


Questo esempio mostra come creare un file a indice alternativo da file denominato 
INVNTRY con una chiave formata da tre campi e con data creazione 25 GIUGNO 
1984. Il file INVNTRY è un file a indice con chiave sul numero parte da posizione 
1 a 8 del record (lunghezza chiave). Il file a indice alternativo deve essere contras- 
segnato da chiave con data ultimo ordine, da posizione 64 a 69 del record (lun- 
ghezza chiave 6), codice fornitore, da posizione 70 a 75 (lunghezza chiave 6) e 
numero parte. Il file a indice alternativo deve essere denominato LOINVTRY, e deve 
avere una locazione preferita di A3. 


BLDINDEX LOINVTRY,64,6, INVVTRY,062584,A3,70,6,1,8. 
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PROCEDURA BLDLIBR 


La procedura BLDLIBR crea una nuova libreria e, facoltativamente, copia su disco, 
su minidisco, su nastro o nastro a cassetta, nella nuova libreria un file contenente 
uno o più membri di libreria. 


Il file contenente i membri da copiare, deve essere stato creato dalla procedura 
FROMLIBR o dal programma di utilità $MAINT. Vedere la Procedura FROM- 
LIBR od il Programma di utilità $MAINT, funzioni addizionali per ulteriori infor- 


mazioni sulla creazione di questo file. 


La procedura BLDLIBR esegue il programma di utilità $MAINT. 


nome libreria,ampiezza libreria, ampiezza indirizzario ,(Al 
AQ 
A3 
AÙ 
numero blocco 


[none gilel s|Il| ,{|mmggaa| , Sl » | AUTO A REAWE 
ggmmaa S2 NOAUTO LEAVE 


S3 UNLOAI 
Ml.nn 
M2.nn 





aammgg 


nome libreria specifica ta nuova libreria. Un nome di libreria può avere fino a 8 
caratteri e deve iniziare con un carattere alfabetico (da A a Z, #, $ 0 @}). 
I rimanenti caratteri possono essere una qualsiasi combinazione di caratteri 
(numerici, alfanumerici e speciali). Occorre evitare di usare i seguenti carat- 
teri in quanto hanno dei significati speciali nelle procedure: virgole (,), api- 
ci ('), spazi vuoti, punti di domanda (?), barrette (/), segni di maggiore di 
{>}, segni più (+), segni meno (—) e segni di uguale (=). Non usare come 
nome di libreria # LIBRARY, F1, READER, PRINT, DISK, TAPE o ALL. 


ampiezza libreria specifica la dimensione in blocchi della nuova libreria. Un bloc- 
co contiene 2.560 byte. La dimensione massima di libreria è di 15.000 bloc- 
chi. 


ampiezza indirizzario specifica la dimensione in settori dell’indirizzario per la 
nuova libreria. La dimensione minima di indirizzario è di due settori. La di- 
mensione massima di indirizzario è di 2.500 settori. Un blocco di libreria 
contiene 10 settori. 


Se non viene specificata una dimensione di indirizzario; viene assunto un va- 
lore di 1/100 della dimensione della libreria (con un minimo di 2 settori). 
Per esempio, se si specifica una dimensione di libreria di 100 blocchi e non 
si specifica una dimensione di indirizzario, vengono riservati 10 settori di in- 
dirizzario (ricordarsi che 10 settori formano 1 blocco). 


Per determinare il numero delle entrate di indirizzario disponibili per un dato 
numero di settori, moltiplicare il numero dei settori per 5 e sottrarre 7 dal 
risultato. Per esempio, per 10 settori di indirizzario, sarebbe possibile avere 


fino a 43 entrate (5x10 = 50; 50-7 = 43). 


L'indirizzario contiene il nome e la dimensione e altre informazioni generali 
su ciascun membro nella libreria, 


A1, A2, A3 o A4 indica la preferenza del disco; cioè l'unità disco che viene esa- 
minata per prima alla ricerca di spazio disponibile. Se non è disponibile suf- 
ficiente spazio su quell’unità, vengono esaminate le altre unità (se esistono) 
ed il file viene inserito sull'unità disco meno usata. Se non è specificata 
alcuna locazione ed il sistema ha più di un'unità disco, il file viene inserito 


sull'unità disco meno usata, 


A1 specifica che la locazione preferenziale del file su disco è sul primo disco, 
se è disponibile spazio. 


A2 specifica che la locazione preferenziale del file su disco è sul secondo di- 
sco, se è disponibile spazio. 


A3 specifica che la locazione preferenziale del file su disco è sul terzo disco, 
se è disponibile spazio. 


A4 specifica che la locazione preferenziale del file su disco è sul quarto disco, 
se è disponibile spazio. 


. numero blocco specifica la locazione del primo blocco della libreria. E' possibile 


specificare fino a 6 cifre. E’ possibile usare la procedura CATALOG per de- 
terminare dove sono disponibili blocchi di spazio sul disco. 


nome file specifica il file contenente uno o più membri di libreria da copiare nel- 
la nuova libreria. 


11 specifica che il file contenente i membri di libreria da copiare è su minidisco. Se il no- 
me file è specificato ma non è specificato L1, F1, T1, T2, o TC si presume L 1. 


F1 specifica che il file contenente i membri di libreria da copiare si trova su disco. 


T1 specifica che il file contenente i membri di libreria da copiare si trova sul- 
l’unità nastro 1, 

T2 specifica che il file contenente i membri di libreria da copiare si trova sul- 
l'unità nastro 2. 


TC specifica che il file contenente i membri di libreria da copiare è su nastro a cassetta. 


mmggaa, ggmmaa o aammgg specifica la data di creazione del file contenente i 
membri di libreria da copiare. La data, se specificata, deve essere nel formato 
della data di sessione; usare il comando STATUS SESSION per determinare 
il formato della data di sessione. Se viene specificato F1 e non viene specifi- 
cata una data, viene usato il file col nome specificato e con ia data di crea- 
zione più recente. Se viene specificato o assunto 11 e non viene specificata 
una data, il programma elabora il primo file nella VTOC del minidisco con il 
nome file specificato. 


S1, S2 o S3 specifica l'alimentatore a minidischi contenente il primo minidisco 
da usare. Se non è specificata alcuna posizione di minidisco, si assume S1. 
Questo parametro è valido soltanto se nel sesto parametro c'è 11. 


M1.nn o M2.nn specifica la locazione di caricatore contenente il pirmo minidisco 
da usare. M1 indica il primo caricatore, M2 indica il secondo. nn è un valore 
decimale da 01 a 10 che identifica la locazione del minidisco nel caricatore. 
M1 equivale a specificare M1.01; M2 equivale a specificare M2.01. 

Questo parametro è valido soltanto se nel sesto parametro c'è 11. 
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AUTO specifica quanto segue: 


e Se vengono specificato S1, $2 o $3, possono essere usati tutti e tre i sin- 
goli alimentatori (S1, S2 e S3). L'elaborazione inizia col minidisco nel- 
l'alimentatore specificato e continua fino al minidisco nell'alimentatore 
S3. Se occorrono altri minidischi, viene visualizzato un messaggio e 
l'operatore deve inserire i successivi minidischi. L'elaborazione riprende 
con il minidisco nell'alimentatore S1. 


e Seè specificato M1.22 o M2.nn, possono essere usati entrambi i carica- 
tori (M1 o M2). L'elaborazione inizia col minidisco nella locazione speci- 
ficata e continua fino al minidisco nella locazione M2.10. Se occorrono 
altri minidischi, viene visualizzato un messaggio e l'operatore deve inseri- 
re i successivi caricatori. L'elaborazione riprende alla locazione M1.01. 


e Sevienespecificato T1 o T2, quando ia bobina del nastro sull'unità nastro 
originale è terminata, il sistema passa all'altra unità nastro, se disponibile, 
per continuare l'elaborazione (da T1 a T2 o da T2 a T1). Se l’altra unità 
nastro non è disponibile sarà utilizzata di nuovo la prima. Una richiesta ve- 
rificherà che la bobina caricata sia quella giusta. 


e Seèspecificato TC, il parametro AUTO/NOAUTO è ignorato poiché è pre- 
sente soltanto l’unità a cassetta. 


Se non è specificato un nono parametro, si presume AUTO. 
NOAUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, può essere usato soltanto l'alimentatore 
specificato. Se occorrono altri minidischi, viene visualizzato un messaggio 
e l'operatore deve inserire il successivo minidisco nell'alimentatore speci- 
ficato. 


e Se viene specificato M1.nn o M2.nn, può essere usato soltanto il carica- 
tore specificato. L'elaborazione inizia col minidisco nella locazione spe- 
cificata e continua fino all'ultimo minidisco nel caricatore. Se occorrono 
altri minidischi, viene visualizzato un messaggio e l'operatore deve inse- 
rire il successivo caricatore nell'alimentatore usato. L'elaborazione ripren- 
de alla prima locazione nel caricatore. 


e Se viene specificato T1 o T2, verrà usata soltanto l’unità nastro specifi- 
cata per tutti i volumi nastro. 


e Seèspecificato TC, il parametro AUTO/NOAUTO è ignorato poiché è pre- 
sente soltanto l’unità a cassetta, 


REWIND specifica che il nastro deve essere riavvolto dopo che è stata eseguita la 
procedura BLDLIBR. Se questo parametro non viene specificato, si presume 
REWIND. Questo parametro non è ammesso se è specificato -F1 o 11. 


LEAVE specifica che il nastro deve essere lasciato dove si trova dopo che è stata 
eseguita la procedura BLDLIBR. La successiva operazione inizia da questa posi- 
zione. Questo parametro non è ammesso se è specificato F1 o 11. 


UNLOAD specifica che il nastro deve essere riavvolto e scaricato dopo che è stata 
descritta la procedura BLDLIBR. Questo parametro non è ammesso se è spe- 
cificato F1 0 11. Se è specificato UNLOAD e TC, il nastro sarà riavvolto dopo 
l'elaborazione. 


id volume specifica l'id volume della bobina del nastro. 


Esempio 1 


Creazione di una libreria denominata MYLIB che deve avere una dimensione di 
100 blocchi. Si presume una dimensione di elenco di 10 settori. 


BLDLIBR MYLIB,100 


Esempio 2 


Questo esempio mostra come creare una nuova libreria e copiare uno o più mem- 
bri di libreria da un file su minidisco. La libreria deve essere denominata YOUR- 
LIB, deve avere una dimensione di:75 blocchi ed avere un elenco di 15 settori. 
Il file su minidisco è denominato MEMBERS; il minidisco è nell’alimentatore 1. 


BLDLIBR YOURLIB,75,15, MEMBERS 
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PROCEDURA BLDMENU 


La procedura BLDMENU genera, da membri origine, i membri di libreria richiesti 
per visualizzare un menù. Un menù consente all'operatore di avviare un lavoro se- 
lezionando un certo numero di opzioni invece di immettere un comando o una 
procedura. E’ possibile definire in un menù fino a 24 numeri di opzione (da 1 a 


24). 


Le informazioni sul modo in cui costruire il menù, si possono trovare nel manua- 
le Guida alla Definizione dei Tracciati Video. 


E’ possibile creare due tipi di menù con BLDMENU: menù a tracciato libero e 
menù a tracciato fisso. ° 


Per visualizzare un: menù, l'operatore può immettere il nome del menù sullo 
schermo di collegamento oppure usare il comando MENU. Per rimuovere un me- 
nù correntemente visualizzato, l'operatore immette uno zero (0) invece di un nu- 
mero di opzione. La procedura BLDMENU esegue i programmi di utilità 
$BMENU. Essa esegue anche il programma di utilità $MAINT (procedura LIBR- 
LIBR) e il programma di utilità $SMGBLD (procedura CREATE). 


L'immissione alla procedura BLDMENU è: 


e Un membro origine di messaggi di secondo livello denominato membro origi- 


ne comandi. li membro origine comandi è indispensabile e contiene i coman- 
di e le procedure usate come immissione quando l'operatore sceglie opzioni 
del menù. 


e Un membro di messaggi di primo livello denominato membro origine testo 
menù. Il membro origine testo menù è indispensabile per i menù a tracciato 
libero, ma è facoltativo per i menù a tracciato fisso. Esso definisce il testo 


che compare sul menù. 


L'emissione della procedura BLDMENU è: 


e Un membro oggetto di messaggi di secondo livello denominato membro og- 
getto di comandi, che BLDMENU crea dal membro origine comandi. BLD- 
MENU inserisce il membro oggetto comandi nella libreria di emissione spe- 
cificata sulla procedura BLDMENU. Questo membro deve essere creato per 
poter visualizzare un menù. 


e Un membro oggetto di messaggi di primo livello denominato membro og- 
getto testo menù, che BLDMENU crea dal membro origine testo menù fa- 
facoltativo. BLDMENU inserisce il membro oggetto testo menù nella libre- 
ria di emissione specificata sulla procedura BLDMENU. Questo membro è 
usato per creare il membro oggetto del tracciato video per il menù. 


e membro oggetto di tracciato video per il menù, BLDMENU inserisce il 
membro oggetto di tracciato video nella libreria di emissione specificata sulla 
procedura BLDMENU. Questo membro deve essere creato per visualizzare un 
menù. 


e Una lista che contiene: 


— Una lista parziale $SFGR. 

— | numeri di opzione e le corrispondenti specifiche dal membro origine 
comandi. 

— Il testo dello schermo effettivo che compare sullo schermo. 


BLDMENU nome menù, [ pome membro testo] ,|libreria membro origine 


libreria corrente 


libreria membro oggetto) , [RrPLACE ; [ keer | î [ FREEPORM | 
libreria corrente ui E 








nome menù specifica il nome dato al membro oggetto di tracciato video per il 
menù. | nomi del membro origine comandi e del membro oggetto comandi 
(il nome specificato nella prima riga del membro origine comandi), devono 
essere nome menù ##- Per esempio se ii nome di un menù è MENU, il no- 
me del membro oggetto comandi deve essere MENU##. Poiché ## viene ag- 
giunto al nome del menù da BLDMENU, si riceve un messaggio di errore se 
il nome del menù contiene più di 6 caratteri. 


nome membro testo specifica il nome da 1-8 caratteri del membro origine testo 
menù se esiste. ll nome non può essere identico al nome del menù. li nome 
del membro oggetto testo menù (nome specificato nel primo record del 
membro origine testo menù) deve essere lo stesso del nome membro origine. 
Il nome testo è facoltativo soltanto se non è richiesto FREEFORM. Se il 
nome testo non è specificato, BLDMENU usa le informazioni nel membro 
oggetto comandi per generare il testo descrittivo per le opzioni nei menù a 


tracciato fisso. 


libreria membro origine specifica la libreria che contiene le specifiche origine. Se 
non è specificata una libreria di immissione, viene assunta la libreria corrente. 


libreria membro oggetto specifica la libreria che conterrà il membro oggetto di 
tracciato video per il menù, il membro oggetto comandi e, se è specificato 
KEEP, il membro oggetto testo menù. Se non è specificata la libreria di im- 
missione, viene presunta la iibreria corrente. 


Nota: se la libreria di immissione e la libreria di emissione non sono le stes- 
se, BLDMENU copia i membri origine di immissione sulla libreria di emis- 
sione quando inizia l'elaborazione. Pertanto, quando viene eseguito BLD- 
MENU, la libreria di emissione deve avere sufficiente spazio per contenere i 
due. membri origine di immissione, nonché i membri oggetto creati da 
BLDMENU. BLDMENU rimuove i membri origine dalla libreria di emissione 
prima di terminare. 
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REPLACE specifica che: 


® Se esiste già un membro oggetto o tracciato video nella libreria di emis- 
sione con lo stesso nome del menù che viene creato, BLDMENU can- 
cella automaticamente il membro esistente dalla }ibreria di emissione. 


e  Seesiste già nella libreria di emissione un membro oggetto, che non è un 


membro oggetto di tracciato video, con lo stesso nome del menù che ‘ 


viene creato, BLDMENU visualizza un messaggio di errore. L'operatore 
deve quindi decidere se sostituire il membro esistente nella libreria di 


emissione oppure cancellare it lavoro. 


e Se il nome del membro origine comandi o del membro origine testo 
menù è lo stesso di un membro origine o di un membro oggetto nella 
libreria di emissione, BLDMENU automaticamente sostituisce i membri 
esistenti nella libreria di emissione. 


Se non viene specificato REPLACE, si verifica quanto segue: 


e Se esiste già un membro oggetto nella libreria di emissione con lo stesso 
nome del menù che viene creato, BLDMENU visualizza un messaggio di 
errore. L'operatore deve quindi decidere se cancellare il membro esisten- 
te nella libreria di emissione o cancellare il lavoro. 


e Se il nome del membro origine comandi o il membro origine testo menù 
è lo stesso di un membro origine nella libreria di emissione, BLDMENU 
visualizza un messaggio di errore e cancella il lavoro. 


Nota: se un menù viene ricostruito mentre è visualizzato sul terminale video, 
occorre richiedere il menù ricostruito immettendo il comando di controllo 
MENU. Questo è necessario in quanto la vecchia versione del menù è ancora 
visualizzata e può non essere la stessa per l'immissione di comandi definita 
per il nuovo menù. 


KEEP specifica che se viene specificato anche il parametro nome del membro te- 


sto, il membro oggetto testo menù creato da BLDMENU, deve rimanere nel- 
la libreria di emissione. Se non è specificato KEEP, il membro oggetto testo 
menù, viene cancellato dalla libreria di emissione prima che termini BLD- 
MENU. 


Il membro oggetto testo menù è usato soltanto dal programma di utilità 


$BMENU per creare il membro oggetto di tracciato video e non è richiesto 
dopo che il menù è stato costruito. 


FREEFORM specifica che deve essere creato un menù in tracciato libero. Se non 


è specificato FREEFORM, viene creato un menù a tracciato fisso. Se viene 
specificato FREEFORM, deve essere anche specificato un nome di testo. 


Si è creato un membro origine comandi denominato MENU2## e un membro 
origine testo menù denominato MENU2DT, entrambi i membri sono memorizzati 
in una libreria denominata MYLIB. Per costruire un menù denominato MENU2 
usando la procedura BLDMENU, è possibile immettere quanto segue. | membri di 
libreria creati da BLDMENU devono essere inseriti in una libreria denominata 
MYLIB e il membro oggetto testo menù creato da BLDMENU, deve essere can- 
cellato da MYLIB prima che BLDMENU termini. 


BLDMENU MENU2,MENU2DT,MYLIB,MYLIB,,,FREFFORM 


x 


n 


BUILD 


PROCEDURA BUILD 


La procedura BUILD consente di visualizzare e correggere i dati sul disco dopo 
un errore di disco. Se è attiva la riservatezza con parola d'ordine, BUILD può 
essere eseguito soltanto da un'operatore con una classificazione di riservatezza 
di operatore di sistema o più elevata, oppure da Un operatore che lavora su una 
unità video di servizio di sistema. La procedura BUILD può essere eseguita da 


qualsiasi unità video ma soltanto da un operatore alla volta. 


La procedura BUILD cerca in tutti i settori del disco .i dati che non erano leggi- 
bili a causa di un errore di lettura. Quando trova un errore, ciascun settore con- 
tenente dati illeggibili, viene stampato unitamente ai settore logicamente prece- 
dente e al settore logicamente seguente a quello contenente i dati illeggibili. 
Tutti i settori aventi dati illeggibili vengono anche visualizzati su schermo. 

Usando lo schermo BUILD, è possibile lasciare i dati come sono o correggerli. 

Se veniva eseguita la procedura COMPRESS mentre sì è verificato l'errore del di- 
sco e successivamente si è eseguita ia procedura BUILD, viene richiamata automa- 
ticamente la procedura COMPRESS dalla procedura BUILD per terminare la com- 
pressione del disco originale. 


La procedura BUILD esegue il programma di utilità $BUILD, 


La procedura BUILD non ha parametri. 
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Esempio 


Per controllare un file dopo un errore di immissione/emissione in un file su disco, 
l'operatore dovrebbe immettere quanto segue: 


BUILD 


{ dati vengono visualizzati e stampati in formato esadecimale e alfanumerico. | dati 
sono listati nel formato alfanumerico sulla prima riga. Se il carattere non può essere 
visualizzato, viene sostituito da uno spazio vuoto. | dati sono visualizzati in formato 
esadecimale sulla seconda e terza riga. La cifra esadecimale più a sinistra è visualiz- 
zata sulla seconda riga; la cifra esadecimale più a destra è visualizzata sulla terza riga. 
Per esempio: 


$6B6FF FFIROIC6 C9030C540 40404000 H 09E20000 01000008 00050800 D2020405 4 *  f 








FFFFCCACCCEFFCF ACFOFCFFFAFEFFEFEF3COFFCFEFFFAFFEFEFE FAFRFAEFEFFFACFEFCRCF3005448FF 
bbB666066A201360394335400404040004840052000000100000510)00050800042023435495C066FF 


COL=00001 SS-0ZA89LO1 NOME FILE-DATAMAST 
Cmdl - Riscrivi settore Cmd3 - Salta settore 


Subito dopo i dati alfanumerici ed esadecimali viene visualizzato il nome del file il 
cui settore risulta illeggibile. Se appare NOFILE, questo significa che il settore illeg- 
gibile non appartiene ad alcun file utente o libreria. Il dato illeggibile potrebbe esse- 
re o su uno spazio disco inutilizzato o su un file di sistema. Quando appare NOFILE 
è necessario ricaricare l'SSP o il programma di microcodifica, o entrambi. 


Dopo la visualizzazione dei dati illeggibili, è possibile fare una tra le cose seguenti: 


e Premere il tasto di comando 3 per far sì che venga visualizzato il successivo 
settore con dati leggibili. Il settore che era stato visualizzato non viene modi- 
ficato e sarà visualizzato di nuovo in occasione della successiva esecuzione 
della procedura BUILD (a meno che non venga eseguito un lavoro che scriva 

i dati su quel settore, riparando così i dati illeggibili). 


e  Correggere i dati illeggibili usando i tasti di scorrimento per visualizzare la 
porzione del settore contenente i dati da correggere. Immettere i dati corretti 
sulla riga dei caratteri alfanumerici o sulla riga dei caratteri esadecimali: 


Dopo aver corretto il settore, premere il tasto di comando 1. Il settore cor- 
retto viene riscritto sul disco e viene visualizzato il successivo settore con da- 
ti illeggibili (posto che ce ne sia uno). Il settore corretto non verrà visualiz- 
zato la successiva volta che viene eseguita la procedura BUILD. 


SI 


CACHE 


| PROCEDURA CACHE 


| 
| 


| 


ALTE 


START 


STOP 


La procedura CACHE consente all'operatore di sistema di creare, modificare, o can- 
cellare il cache su disco. Quest'ultimo è una memoria di transito utilizzata per man- 
tenere dati su disco in memoria principale allo scopo di ridurre il numero degli ac- 
cessi ai dischi. ; 


Non appena sono inviate le operazioni di lettura disco, viene per primo controllato 
il cache per determinare se contiene i dati richiesti. Se così, questi vengono sempli- 
cemente mossi nella memoria di transito dell'utente; altrimenti un'intera pagina ca- 
che contenente i dati richiesti viene letta nel cache e poi i dati portati nella memoria 
di transito utente. 


Le operazioni di scrittura disco aggiorneranno sia il disco che la memoria di transito. 
Quando la procedura viene usata per modificare il cache, questo viene liberato e 
ricostruito con la nuova ampiezza e ampiezza pagina. Quando viene usata per arre- 


stare l’attività del cache, la memoria viene liberata per altri utilizzi. 


La procedura CACHE esegue il programma di utilità $SVCASRV. 


RI, [ampie , |ampiezza pagina 


2K 


ALTER specifica la memoria o ampiezza pagina deli cache che si deve modificare. 


START specifica che il cache deve essere avviato. Se non specificato, viene assun- 
to START. 


STOP specifica che il cache deve essere arrestato. Ampiezza e ampiezza pagina non 
sono validi con STOP. 


Ampiezza specifica l'ampiezza del cache in K-byte. Il minimo che si può indicare 
è 64K ed il massimo 1024K. La memoria sarà diversa da quella dell’area uten- 
ti. Se non specificato, il valore assunto sarà un quarto dell’ampiezza della me- 
moria principale. Per esempio, se la memoria principale è 1 Mb, il cache sarà 
256 Kb. 


Ampiezza pagina specifica l'ampiezza di ciascuna pagina cache in Kb. È la parte 
più piccola contigua di dati disco che può essere raccolta in un cache. Ampiez- 
ze consentite sono 1, 2, 4, 8, o 16 Kb. Se non specificato, viene assunto 2Kb. 


NOTA: | parametri ampiezza e ampiezza pagina dovranno essere specificati in mo- 
do tale da costituire almeno 32 pagine cache. 


Esempio 


Questo esempio mostra come avviare un cache di 64Kb con ampiezza pagina di 2 Kb. 


CACHE START,64,2 
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Pagina lasciata intenzionalmente bianca 
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CATALOG 


CATALOG 


CATALOG 


PROCEDURA CATALOG 


ALL 


nome file A 


La procedura CATALOG elenca i nomi dei file, delle librerie e delle cartelle su disco, 
su minidisco, su nastro o nastro a cassetta. È possibile listare tutte le entrate su 
disco, minidisco o nastro, oppure listare una singola entrata. La procedura CATA- 
LOG legge l'indice del volume {(VTOC) per il disco e il minidisco. La VTOC del disco 
contiene un'entrata per ciascun file, ciascuna libreria e cartella sul disco mentre una 
VTOC di minidischi contiene un'entrata per ciascun file sul minidisco. Ciascuna en- 
trata VTOC identifica il corrispondente file o libreria per nome, data di creazione 
e locazione. La procedura CATALOG legge l’identificazione di volume e le informa- 
zioni di identificazione di testata contenute su un nastro o nastro a cassetta con 
un’identificazione standard. 


L'emissione viene listata sull'unità di lista del sistema. Per determinare l’unità di 
lista del sistema, immettere il comando STATUS SESSION. Per cambiare l’unità 
di lista del sistema, vedere la procedura SYSLIST oppure la procedura PRINT. La 
procedura CATALOG esegue il programma di utilità #LABEL. 


Per listare le informazioni sul disco: 


5 nl NAME 


LOCATION 


nome libreria 


ALL 


nome file sl 


ALL 


nome file TO 
nome libreria UNLOAD 


Per listare le informazioni sul minidisco: 


sIl, |locazione iniziale|,|locazione finale , | NAME 


locazione iniziale 
52 SIL ; 

53 52 

Ml.nn S3 

M2.nn Ml.nn 

M2.nn 


Per listare le informazioni sui nastri o nastri a cassetta. 


(TI)... | NAME , | REWIND 
LOCATION LEAVE 





LOCATION 
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ALL specifica che tutti i nomi di file, di libreria e di cartella devono essere listati. Se 
il primo parametro non è specificato, si presume ALL. 


nome file, nome libreria o nome cartella specifica il file, la libreria o la cartella di cui 
devono essere listate le informazioni VTOC. Per il nastro, viene listata l'infor- 
mazione di identificazione. Se esiste più di un file con il nome indicato, vengo- 
no listate le informazioni per tutti i file con quel nome. 


F1 specifica che devono essere listate le entrate VTOC per il disco, Se non è spe- 


cificato il secondo parametro, si presume F1. Vedere Liste campione VTOC 
del disco per la descrizione delle opzioni della lista, 


11 specifica che le entrate VTOC per un minidisco devono essere listate. Vedere 
Liste campione VTOC del minidisco per una descrizione delle opzioni sulla 
lista, 


T1 specifica che devono essere listate le informazioni di identificazione per il na- 
stro montato sull'unità nastro 1. Vedere per la descrizione delle opzioni della 
lista l'’Esempio di una Lista di identificazione nastro. 


T2 specifica che devono essere listate le informazioni di identificazione per il na- 
stro montato sull'unità disco 2. Vedere l'Esempio di una Lista di identifica. 
zioni nastro. 


TC specifica che deve essere listata l'informazione di identificazione del nastro a 
cassetta. Vedere più avanti Lista campione di identificazione nastro. 


NAME specifica che le entrate sono da selezionare e listare per nome in ordine 
alfabetico. Se non è specificato il quinto parametro, si presume NAME. 


LOCATION specifica che le entrate devono essere selezionate e listate per se- 
quenza di locazione sul disco, sul minidisco o sul nastro. 


locazione iniziale specifica la locazione iniziale dell’'alimentatore a minidischi da 
usare da CATALOG. Se il primo parametro non è specificato, si presume S1, 
Questo parametro non è ammesso se vengono specificati F1,T1,T2 0 TC, oppure 
è ignorato se il sistema non dispone di un'unità a minidischi a caricatore. La 
locazione iniziale deve essere minore o uguale alla locazione finale. 


locazione finale specifica la locazione finale dell’alimentatore a minidischi da usa- 
re da CATALOG. Se questo parametro non è specificato, si presume la loca- 
zione iniziale. Questo parametro non è ammesso se viene specificato F1, T1, 
T2 o TC, oppure è ignorato se il sistema non dispone di un'unità a minidischi 
a caricatore. 


La locazione finale (se specificata) deve essere maggiore di o uguale alla loca- 
zione iniziale e non deve provocare un salto dagli alimentatori del minidisco 
(S1, S2 e S3) agli alimentatori del caricatore (M1 e M2). Per esempio, non è 
corretto specificare una locazione iniziale di S3 e una locazione finale di M1. 
E’ possibile specificare una locazione iniziale nel caricatore î e una locazione 
finale nel caricatore 2. 


Le locazioni finali e iniziali possono essere una fra le seguenti: 
S1, S2 o S3 specifica uno dei tre alimentatori a minidisco. 


M1 o M2 specifica uno dei due alimentatori di caricatore. Se vengono specificati 
M1 o M2 come locazione iniziale e non viene specificata alcuna locazione fi- 
nale, viene elaborato l’intero caricatore (tutte e 10 le posizioni). Specificare 
M1 o M2 come iocazione finale equivale a specificare rispettivamente M1.10 
oppure M2.10. 


M1.nn o M2.nn specifica una posizione nell'ambito di un caricatore. nn è un nu- 
mero che va da 01 a 10 che specifica la posizione nell’ambito del caricatore. 


REWIND specifica che il nastro deve essere riavvolto dopo che è stata eseguita la 
procedura CATALOG. Se questo parametro non viene specificato, si presume 
REWIND. Questo parametro non è ammesso se è specificato F1 o I1. 


LEAVE specifica che il nastro deve essere lasciato dove si trova dopo che è stata 
eseguita la procedura CATALOG. L'applicazione successiva inizia da quella po- 
sizione. Questo parametro non è ammesso se è specificato F1 o |1. 


UNLOAD specifica che il nastro deve essere riavvolto e scaricato dopo che è stata 
descritta la procedura CATALOG. Questo parametro non è ammesso se è 
specificato F1, 11 o TC. 
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Esempio 1 


Visualizzazione di informazioni VTOC per il file su disco denominato PAYROLL: 


CATALOG PAYROLL 


Esempio 2 


Lista per nome dei nomi dei file su minidisco nell’alimentatore 1: 


CATALOG ALL,Il 


Esempio 3 


Lista per nome di tutti i file, librerie e cartelle sul disco: 


CATALOG 


Esempio 4 


Lista per locazione dei nomi di tutti i file dei caricatore neil’atimentatore 1: 


CATALOG ,I1,M1,,LOCATION 


Esempio 5 


Lista per locazione dei nomi di tutti i file nelle posizioni da 1 a 5 del caricatore 
dell'alimentatore 2: 


CATALOG ,I1,M2.01,M2, 05, LOCATION 


Esempio 6 


Listare, per nome, tutti i file su un nastro sull’unità nastro 1 e riavvolgere il na- 
stro al termine: 


CATALOG ALL,T1 


Esempio 7 


Listare, per locazione, i nomi di tutti i file su un nastro sull'unità nastro 2 e la- 
sciare il nastro posizionato dopo l’ultimo file: 





CATALOG ,T2,,,LOCATION, LEAVE 


Liste campione della VTOC del disco 


Le seguenti liste mostrano un’emissione stampata campione della VTOC del di- 
sco. ll primo esempio mostra la VTOC listata per nome e ii secondo esempio mo- 
stra la VTOC listata per locazione. Dopo gli esempi c'è una descrizione delle op- 
zioni delle liste. 


Valla 


Lista VTOC del disco per nome 


#X#W*PINE VISUALIZZAZIONE VTOC®##WW 


VISUALIZZAZIONE VTOC DISCO È PAG. pi 
PACK — SYSSSP ID TITOLARE - 830123 PER NOME FILE 
DATA - 12/09/8637 
CAPACITA DISPOS.- 398.74 MEGABYTE / 155758 BLOCCHI 7 ORA - 11.30 
CODICI STATO 1 - CAPACE DI CANCELLAZIONE 3 - CHIAVI RIP. NON PERMESSE 5 - FILE/LIBR PROTETTI PREC 
2 - CHIAVI RIPETUTE PERMESSE 4 - FILE/LIBR.PROTETTI 6 — FILE TRACCIA ATTIVI 
eee FILE i] RECORD--------- -CHIAVE- .--ALLOCAZIONE- ORIGINARIO --POSIZIONE- 
IDENTIF.. DATA = ORG. TIPO STATO LUNGH. USATI DISPONIB. POS. LUN. RECORD BLOCCHI NUM ALTER BLOC. NUM PREF 
##J0BQ 12/09/83 SISTEMA . ; 15 A 155987 
##SPOOLI 09/09/83 SISTEMA 400 156002 A2 
. #LIBRARY SISTEMA 5139 2367 
#SECRESO 21/06/83 SISTEMA 4 152362 
#SECUIDO 20/05/83 SISTEMA 5 3 147215 
#SERVLOG 19/05/83 SISTEMA ‘ 5 155982 
#SYSHIST 15/07/83 SISTEMA 100 TT 
#SYSTASK 15/07/83 SISTEMA 1550 817 
#SYSWORK 15/07/83 SISTEMA ET 650 
* $.MONTHC 23/08/83 S È 512 8 2 20 2 152377 
$.MONTHD 23/08/83 S 1 512 18 2 20 kh 152379 
$. De 23/08/83 Ss 1 512 8 2 © 10 2 152371 
$.yxTDD 23/08/83 S 1 512 18 2 20 4 152373 
$$.ADCAG 18/08/82 s 3 1 852 853 x 152366 
$$.ADRAC 20/07/83 S 3 608 1098 1706 2 148371 
$$.ADRAP 12/05/83 S 3 65 26h1 1706 2 149183 
$$.ADRAT 12/08/82 Ss 3 3 1703 1706 2 1547905 
$5.ADRCN 12/05/83 S 3 2 270h 1706 2 147826 
$$.ADRDE 27/06/83 S 3 223 630 B53 1 1h7902 
$$.ADRFE 29/06/83 S 3 868 838 1706 2 148333 
$$.ADRFO 29/06/83 S 3 868 838 1706 2 148345 
$$.ADRIC 28/06/83 S 3 23 1683 1706 2 145268 
$$.ADRII 28/06/83 S 3 2 1704 1706 2 145329 
$$.ADRMD 12/08/82 S 3 33 1673 1706 2 ‘147903 
$$.ADRMO 12/05/83 S - 3 2 1704 1706 2 149181 
$$.ADRRI 29/06/83 S 3 68 785 > 853 è 147857 
$$.ALFAD 23/06/82 S 3 92 Tél 853 1 148049 
$$.ALFGF 27/11/82 S 3 ho 813 853 1 147856 
$$.ANAGR 02/08/82 I 3 220 92 61 17 153 u 149167 
$$.CDESC 15/06/82 I 3 80 372 640 6 20 1012 pei 149126 
$$.CENTR 14/06/82 I 3 160 38 66 25 104 T 149119 
$$.CESIO 02/08/82 I 3 Th 1 178 1 6 179 6 149095 A2 
$$.CICLI 14/06/82 D 128 2000 lo) 2000 50 149045 
$$.CLADD 09/09/83 S 3 Tu 779 853 1 153068 
$5.CLIAD 09/09/83 S 3 ho 813 853 1 153064 
$$.CLIDU 19/01/83 D 1 2560 o 2560 1 147822 
s$.cIMAS 08/07/83 D 39 328 o) 328 5 147817 
$$. CLMEN 02/08/83 -D 55 325 (o) 325 T 147858 
$$.CLSAL 08/07/83 D 100 307 (o) 307 12 147837 
o 
. 
. 
0. 
. 
o. 
TXRM LIBRERIA È 30 142806 
UPDBO11 02/08/83 Ss LIBRFILE 8 1703 857 8 147608 
UPDBO12 02/08/83 8 LIBRFILE 8 1703 857 8 1k7592 
UPO2 02/08/83 S 150 48 3 51 3 147589 
VISIVI LIBRERIA 260 i 134663 
WSID33436 26/08/83 D i 256 400 Do) ho 145617 
ZTRANS 17/02/83 I 3 6h 22 20 60 5 32 1 . 147725 
SPAZIO ATTUALM.DISPONIBILE -- POSIZIONE BLOCCHI 
7909 113535 
121523 50 
121623 86 
121838 7 
. 
. 
. 
14904h pi 
153054 10 
153065 3 
153069 3 
114170 
VOCI VTOC UTENTE - USATE 289/ DISPONIB. 671 
VISUALIZZAZIONE FILE LAVORO PAG. 8 
NOME LAVORO- CATLIST 
i DATA - 12/09/83 
CAPACITA DISPOS.- 398.7% MEGABYTE / 155758 BLOCCHI ORA — 11.30 
CODICI STATO 1 - CAPACE DI CANCELLAZIONE 3 - CHIAVI RIP. NON PERMESSE 5 - FILE/LIBR PROTETTI PREC 
2 - CHIAVI RIPETUTE PERMESSE È - FILE/LIBR.PROTETTI 6 - FILE TRACCIA ATTIVI 
eee PILE RECORD--------—- -CHIAVE-  --ALLOCAZIONE- ORIGINARIO --POSIZIONE- 
IDENTIF. DATA ORG. TIPO STATO LUNGH. USATI DISPONIB. POS. LUN, RECORD BLOCCHI NUM ALTER BLOC. NUM PREF 
JOBl 12/09/83 S 10 (o) 256 256 1 153072 A2 
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Lista VTOC del disco per locazione 


VISUALIZZAZIONE vTOC DISCO PAG. 1 
PACK - SGSSP ID TITOLARE - 820920 PER Polia IO NE DATA - 08/07/83 
ORA - 13.5h 
CAPACITA DISPOS.- 198.53 MEGABYTE / 77554 BLOCCHI 
CODICI STATO 1 - CAPACE DI CANCELLAZIONE 3 —- CHIAVI RIP. NON PERMESSE 5 - FILE/LIBR PROTETTI PREC 
2 - CHIAVI RIPETUTE PERMESSE È - FILE/LIBR.PROTETTI 6 - FILE TRACCIA ATTIVI 
n] FILE-----------------— ———7+--*-RECORD--------- -CHIAVE-  —ALLOCAZIONE- ORIGINARIO —--POSIZIONE- 
IDENTIF, DATA ORG. TIPO STATO LUNGH. USATI DISPONIB. POS. LUN. RECORD BLOCCHI NUM ALTER BLOC. NUM PREF 
#SYSWORK 10/18/82 SISTEMA 67 650 
#SYSHIST 10/18/82 SISTEMA 300 TT 
#SYSTASK 10/18/82 SISTEMA 1100 1017 
#LIBRARY SISTEMA 5000 2117 
FILEA 08/04/82 s 150 25 9 25 2 T11T 
OUTPUT 08/04/82 Ss 48 5 48 20 1 71119 
GSTFILE 09/13/82 D 80 32 (o) 10 3 7120 
FORMFILE 08/27/82 I 1,3 256 7 1 19 1 m121 
Ex2 08/27/82 Ss 3 29 82h 8 1 7122 
FZ 1#W1 09/07/82 S 150 10 T 10 1 7123 
ITEMBALN 08/25/82 I 3 128 31 TI 2 8 100 6 7124 
NEWKON 09/96/82 Ss LIBRFILE 8 71 569 2 7130 
SETUPSHF 09/07/82 1,3,5 To IA su 1 8 50 2 7132 
WDFULIB LIBRERIA 150 7134 
WWSULIB î LIBRERIA 150 7284 
° te) 
[e] {°) 
{°] [e] 
KING : LIBRERIA L 450 31214 
TIM.LOG 10/21/82 100 5120 (o) 200 31664 
SMF.TOG ‘10/22/82 256 2000 o) 200 31864 
SPAZIO ATTUALM. DISPONIBILE -- POSIZIONE BLOCCHI 
9908 T 
9939 5 
31192 22 
32064 u6lbo 
46656 
VOCI VTOC UTENTE - USATE 158/ DISPONIB. 802 
| VISUALIZZAZIONE FILE LAVORO PAG. 8 
NOME LAVORO - CATLIST n è 
DATA - 10/24/82 
CAPACITA DISPOS.- 198.53 MEGABYTE / 77554 BLOCCHI î ORA — 10.32 
CODICI STATO 1 - CAPACE DI CANCELLAZIONE 3 - CHIAVI RIP. NON PERMESSE 5 - FILE/LIBR PROTETTI PREC 
2 - CHIAVI RIPETUTE PERMESSE È - FILE/LIBR.PROTETTI 6 - FILE TRACCIA ATTIVI 
Iisisinienisnsiesietziatatata FILE------------ee=----- ---—----RECORD--------- <CHIAVE-  --ALLOCAZIONE- ORIGINARIO  --POSIZIONE- 
IDENTIF, = DATA ORG. TIPO STATO LUNGH. USATI DISPONIB. POS. LUN. RECORD BLOCCHI NUM ALTER BLOC. NUM PREF 
Job? 10/24/82 1 1,3 50 0) 317 1 10 300 8 9871 
JOB 10/24/82 S 100 È) 307 300 12 9971 


*****FINE VISUALIZZAZIONE VTOC#amm 
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Descrizione delle voci sulla lista VTOC del disco 


PAG. indica il numero di pagina del tabulato. 
PACK specifica l'ID di volume dell’identificazione di volume del disco. 
ID TITOLARE specifica 1"1D del titolare dell’identificazione di volume del disco. 


NOME LAVORO specifica il nome del lavoro dal quale ja CATALOG è stata ese- 
guita. Ciò compare soltanto quando esiste un file di lavori. 


DATA specifica la data di sistema nel formato corrente (mm/gg/aa, gg/mm/aa 
oppure aa/mm/gg). 


CAPACITA’ DISPOS. specifica la dimensione del disco in MegaByte e in blocchi 
(un megabyte equivale a un milione di byte). 


ORA specifica l'ora. 


CODICI STATO specifica i codici di stato relativi ai file, alle librerie e alle’ cartelle 
su disco. 


1 Nel file è consentita la cancellazione di record, 


2 Nel file sono ammesse chiavi doppie. 


3° Nel file non sano ammesse chiavi doppie. 
4 Il file, libreria o cartella è protetto dalla riservatezza sulle risorse. 
5 Il file, la libreria o cartella è stato precedentemente protetto dalla riserva- 


tezza sulle risorse. 


6 Il file è un file di traccia attivo. 
7, Il file è descritto esternamente. 
8. li file è su un sistema remoto. 


FILE IDENTIF. specifica l’identificazione del file, della libreria o della cartella. 


FILE DATA specifica quando il file è stato creato. Per le librerie e le cartelle 
questo campo è in bianco. 


FILE ORG. specifica come è organizzato il file: 


$ Sequenziale 

D Diretto 

I Indice 

x indice alternativo 


Spazio in File di sistema o libreria 
bianco 
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o il tipo di cartella: 


DOC 
DIC 
MLG 


Documento 
Dizionario 
Registro Posta 


PRF Profilo 


ML 


Posta 


DWK Documenti di lavoro 


FILE TIPO specifica il tipo di file: 


Spazio in bianco Indica un file di dati 


DUMPFILE Indica un file di copia del contenuto della memoria 


FOLDER indica una cartella 


LIBRERIA Indica una libreria 


LIBREXT indica un'estensione di libreria 


LIBRFILE Indica un file creato dal $MAINT 


| PCD 


ISK Indica il disco virtuale Personal Computer 


RESERVE Indica un'area di riserva 


SISTEMA — Indica un file di sistema 


TRACEFIL Indica un file di traccia 


FILE STATO specifica lo stato del file, della libreria o della cartella. er 


1 


2 


| 8 


Indica un file dal quale è possibile cancellare i record. 

Indica che sono ammesse chiavi doppie. 

Indica che le chiavi doppie non sono ammesse. 

Indica un file, una libreria o una cartella protetti. 

Indica un file, una libreria o una cartella precedentemente protetti. 
Indica un file di traccia attivo 

Indica un file descritto esternamente 


Il file è su un sistema remoto. 


RECORD LUNGH. specifica la lunghezza dei record del file. Si tratta di un numero 
decimale che mostra il numero dei byte in ciascun record. Per le librerie e le 
cartelle questo campo è vuoto. 
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RECORD USATI specifica il numero dei record attualmente contenenti dati nel file. 
Per le librerie, le cartelle e i file di sistema, questo campo è in bianco. 


Il numero di record usati non rispecchia nessun record aggiunto da un utente 
che sta in quel momento utilizzando il file. 

La VTOC non viene aggiornata fino a che l’ultimo utente non ha terminato di 
utilizzare il file. 


RECORD DISPONIB. specifica il numero dei record che possono ancora essere usati 
nel file. Per le librerie, le cartelle e i file di sistema, questo campo è in bianco. 


CHIAVE POS. specifica per un file a indice, la posizione iniziale del campo chiave 
nei record. Se la chiave è formata da due o tre campi, sarà evidenziato NC. (non 
contigui). 


CHIAVE LUN. specifica per un file a indice, la lunghezza del campo chiave nei record. 
Se la chiave è formata da due o tre campi, sarà evidenziata la lunghezza totale. 


ALLOCAZIONE RECORD specifica il numero dei record (in decimali) allocati 
per un file. Il numero indicato può essere maggiore del numero di record 
richiesti poiché I'SSP alloca spazio sul disco a blocchi. Il numero dei record 
allocati è arrotondato al blocco successivo più elevato. Questo numero viene 
mostrato soltanto se il file è stato allocato per record. 


ALLOCAZIONE BLOCCHI specifica il numero di blocchi (in decimali) allocato per 
un file, libreria o cartella. 


ORIGINARIO O NUM ALTER specifica per un file fisico che ha uno o più file 
a indice alternativo, il numero dei file a indice alternativo. Per un file a in- 
dice alternativo invece specifica il file fisico per il quale il file a indice alter- 
nativo è stato costruito. 


Se viene listato uno specifico file e questo è un file fisico, viene mostrata una 
linea aggiuntiva indicante gli indici alternativi. Se il file è a indici alternativi, viene 
mostrata una riga aggiuntiva indicante il file fisico associato. 


POSIZIONE BLOC. NUM specifica il numero di blocco (in decimale) del primo blocco 
del file, libreria o cartella. 


POSIZIONE PREF specifica la locazione preferita sul disco, ossia unità disco A1 o 
unità disco A2, se è stata specificata una locazione preferita al momento della 
creazione del file, della libreria o della cartella. 


SPAZIO ATTUALM. DISPONIBILE specifica la locazione e il numero di blocchi 
dello spazio su disco disponibile. Se non è disponibile alcuno spazio, viene 
listato il seguente messaggio: 


SPAZIO SU DISCO NON DISPONIBILE NEL SISTEMA 


VOCI VTOC UTENTE specifica il numero delle entrate VTOC del disco dell’u- 
tente usate e il numero delle entrate che possono ancora essere usate. 


NOTA: Se viene listato uno specifico file e questo è un file descritto esternamente 
viene mostrata una linea aggiuntiva indicante il dizionario e la definizione as- 
sociati. 
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Lista campione della VTOC del minidisco 


Le seguenti liste mostrano tabulati campione della VTOC del minidisco. ll primo 
esempio mostra la VTOC listata per nome e il secondo mostra la VTOC listata 
per locazione. Dopo gli esempi c'è una descrizione delle voci delle liste. 


Lista VTOC del minidisco per nome 


VISUALIZZAZIONE 

ID VOLUME - IBMIRD ID TITOLARE - OWNERID 
SPAZIO DISPONIB. SU QUESTO VOLUME- 1096 

VOCI VTOC UTENTE - USATE 2 / DISPONIB. 69 


CODICI STATO l- SALVATI USANDO SAVE ALL 


FILE FILE SETTORI FILE FILE 
NOME DATA NEL FILE TIPO STATO 
AGIB 12/09/83 86 SAVELIBR 
FILEl 12/09/83 2 COPYFILE 


****XFINE VISUALIZZAZIONE VTOC***** 


MINIDISCO 


Lista VTOC del minidisco per locazione 


VISUALIZZAZIONE 


ID VOLUME - IBMIRD ID TITOLARE - 
SPAZIO DISPONIB. SU QUESTO VOLUME- 1096 
VOCI VTOC UTENTE - USATE 2 / DISPONIB. 69 


CODICI STATO 1 - SALVATI USANDO SAVE ALL 


FILE FILE SETTORI FILE FILE 

NOME DATA NEL FILE TIPO STATO 
FILEI 12/09/83 2 COPYFILE 
ALIB 12/09/83 86 SAVELIBR 


**KKKFINE VISUALIZZAZIONE VTOC***** 
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MINIDISCO 


PER NOME FILE 
Sl DATA 12/09/83 ORA 12.26 
PER SETTORE 102% BYTE 
FILE RECORD SCADENZA MVF SEQUENZA CREAZIONE 
LOCAZIONE LUNGH. DATA FILE NUMERO SISTEMA 
0003 128 PROTECT IBMSYSTEM36 
0001 60 13/09/83 IBMSYSTEM36 
PER POSIZIONE 
Sì DATA 08/07/73 ORA 13.59 
PER SETTORE 102% BYTE 
FILE RECORD SCADENZA MVF. SEQUENZA CREAZIONE 
LOCAZIONE LUNGH. DATA FILE NUMERO SISTEMA 
0001 60 13/09/82 IBMSYSTEM36 
0003 . 128 PROTECT IBMSYSTEM36 


Descrizione delle voci sulla lista della VTOC del minidisco 


ID VOLUME specifica l'ID di volume del minidisco. 
ID TITOLARE specifica 1"1D del titolare del minidisco. 
DATA specifica la data della sessione (in cui il file è stato salvato) nel formato 


corrente (mm/gg/aa, gg/mm/aa oppure aa/mm/gg). Se un file è stato salvato 
con SAVE ALL {stato file 1), la data indicata è quella di creazione del file 


su disco. 
ORA specifica l'ora, 


S1, S2, S3, M1.nn, M2.nn specifica la locazione del minidisco nel modulo a cari- 
catore, 


SPAZIO DISPONIB. SU QUESTO VOLUME specifica il numero {in decimale) dei 
settori disponibile sul minidisco. Il numero rappresenta la quantità di spazio 


che segue l’ultimo file non scaduto sul minidisco. 


VOCI VTOC UTENTE specifica il numero di entrate della VTOC del minidisco 
usate e il numero di entrate ancora a disposizione, 


FILE NOME specifica il nome del file contenuto sul minidisco. 
FILE DATA specifica quando il file è stato creato su minidisco. 


SETTORI NEL FILE specifica il numero {in decimale) dei settori di minidisco 
che il file usa. 


FILE TIPO specifica il tipo del file come indicato da quanto segue: 


APARFILE indica che il file è stato creato dalla procedura APAR o dal pro- 
gramma di utilità $FEAIDS, 


ARCHIVE indica un file contenente un membro di cartella creato dalla procedu- 
ra ARCHIVE o dal programma di utilità $TMSERV, 


BACKUP indica che il file contenente la libreria è stato creato dalla proce- 
dura BACKUP del Sistema/34 IBM o dai programma di utilità $BACK del 
Sistema/34 IBM. 


COPYFILE indica che il file è stato creato dalla procedura SAVE o dal pro- 
gramma di utilità $COPY. 


EXCHANGE indica un file in formato base di interscambio che è stato crea- 
to dalla proedura TRANSFER o dal programma di utilità $BICR. 


IFORMAT indica un file di scambio tipo | che è stato creato dalla procedura 
TRANSFER o dal programma di utilità $BICA. 


LIBRFILE indica un file contenente uno o più membri di libreria che è sta- 
to creato dalla procedura FROMLIBR o dal programma di utilità $MAINT. 


OLMVFILE indica che il file è un file multivolume fuori linea del Sistema/ 
34 IBM. 
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PROFILE indica che il file contenente la libreria è stato creato dalla proce- 
dura PRSAVE del Sistema/34 IBM o dal programma di utilità $PRSV del 
Sistema/34 della IBM, 


SAVEFLDR indica un file che contiene una libreria che è stata creata dalla proce- 
dura SAVEFLDR o dal programma d'utilità $TMSERV. 


SAVELIBR indica un file che contiene una libreria che è stata creata dalla procedu- 
ra SAVELIBR o dal programma di utilità $MAINT. 


UNKNOW indica che il file non è noto al Sistema/36. 
STATO FILE specifica i codici stato dei file su minidischi 


1 indica che il file è stato salvato con la procedura SAVE ALL | 

2 indica una estensione di cartella 

3 indica dati compressi. Se il file è contenuto anche su un altro dischetto, questo 
stato è evidenziato solo per il primo volume. 


FILE LOCAZIONE specifica it numero (decimale) del primo settore di minidisco 
del file. 


RECORD LUNGH. specifica la lunghezza dei record in un file, Si tratta di un 
numero decimale che indica il numero di byte in ciascun record. Un ‘file 
LIBRFILE o SAVELIBR ha una lunghezza di record di 8. 


DATA DI SCADENZA specifica quando il file su minidisco deve scadere (e cioè 
quando il file non serve più e può essere rimosso). PROTECT indica che il 
file è permanente e che può essere rimosso soltanto usando la procedura 
DELETE. 


MVF FILE specifica se il file è continuato su un altro minidisco secondo i se- 
guenti indicatori: 


Spazio in bianco indica che il file è contenuto su un minidisco e che non è 
continuato. 


C indica che il file è contenuto su uno o più minidischi. 
L indica che questo è l’ultimo minidisco contenente un file continuato. 


NUMERO SEQUENZA specifica, per un file continuato, il numero di sequenza 
del minidisco. Se il file non è continuato, la colonna è in bianco. 


CREAZIONE SISTEMA specifica il sistema IBM che ha creato il file, Se il Siste- 
ma/36 non può dire quale era il sistema che ha creato il file, viene presen- 
tato UNKNOWN. 


Lista campione di identificazione nastro 


Quelli che seguono sono esempi di liste di identificazione di nastri. Il primo 
esempio mostra le identificazioni listate per nome ed il secondo esempio mostra 
le identificazioni listate per locazione. Dopo gli esempi c'è una descrizione delle 
opzioni sulle liste. 


Lista delle identificazioni del nastro per nome 


VISUALIZZAZIONE 


ID VOLUME - TESTI UNITA! - 


CODICE STATO 


T1 


TIPO IDENT. 


1 = SALVATO USANDO SAVE ALL 


NUM. SEQ. TRACCIATO LUNGH. 


IDENT. FILE FILE RECORD 
FILEl a FB 
INVI 2 FB 
MFG 3 FB 
PROCLIBR i FB 
WHSEINFO k FB 


** END OF TAPE LABEL DISPLAY ** 


UT 
65 
256 
256 
200 


IDENTIFICAZIONI 


PE 


- SL 


LUNGH. 


24576 
24576 

4096 
24576 
24576 


R 


NOME 


ID PROPRIETARIO - SDW 


LUNGH. TIPO 


RECORD BLOCCO FILE 


MPHMH 


FILE 


COPYFILE 
COPYFILE 
LIBRFILE 
SAVELIBR 
COPYFILE 


STATO DATA 
CREAZ. 


10/12/83 
10/12/83 
10/12/83 
10/12/83 
10/12/83 


Lista delle identificazioni del nastro per locazione, 


VISUALIZZAZIONE 


ID VOLUME — TESTI UNITA! - 


CODICE STATO 


TI 


P 


TIPO IDENT. 


1 - SALVATO USANDO SAVE ALL 


IDENTIFICAZIONE 


ER 


= SL 


LOCAZIONE 


ID PROPRIETARIO - SDW 


NUM. SEQ. TRACCIATO LUNGH. LUNGH. LUNGH. TIPO 


FILE RECORD 
FILEI 1 FB 
INVI 2 FB 
PROCLIBR 3 FB 
WHSEINFO 4 FB 
MFG 5 FB 


** END OF TAPE LABEL DISPLAY ** 


RECORD 


BT 
65 
256 
200 
256 


BLOCCO 


24576 
24576 
24576 
24576 

4096 


FILE 


FNEMNH 


FILE 


COPYFILE 
COPYFILE 
SAVELIBR 
COPYFILE 
LIBRFILE 


STATO DATA 
CREAZ. 


10/12/83 
10/12/83 
10/12/83 
10/12/83 
10/12/83 


NASTRO 


DATA 
SCAD. 


PROTECT 
PROTECT 
11/11/83 
PROTECT 
PROTECT 


NASTRO 


DATA 
SCAD. 


PROTECT 
PROTECT 
PROTECT 
PROTECT 
11/11/83 


PAG. 1 


DATA - 10/12/83 ORA - 12.37 


MULTIVOLUME 
NUM, SEQ ID VOL 


1 
1 
1 
1 
1 


TESTI 
TESTI 
TESTI 
TESTI 
TESTI 


SISTEMA DI 
CREAZIONE 


IBM SYSTEM/36 
IBM SYSTEM/36 
IBM SYSTEM/36 
IBM SYSTEM/36 
IBM SYSTEM/36 


PAG. 1 


DATA — 10/12/83 ORA - 12.37 


MULTIVOLUME 
NUM. SEQ ID VOL 


l 
1 
1 
1 
1 


TESTI 
TESTI 
TESTI 
TESTI 
TESTI 


SISTEMA DI 
CREAZIONE 


IBM SYSTEM/36 


IBM SYSTEM/26 
IBM SYSTEM/36 
IBM SYSTEM/26 
IBM SYSTEM/36 
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Descrizione delle opzioni sulla lista delle identificazioni del nastro 
ID VOLUME specifica l'ID di volume del nastro, 
UNITÀ specifica quale unità nastro (T1, T2 o TC) contiene il nastro. 


TIPO IDENTIFICAZIONE specifica il tipo di identificazione sul nastro, SL indica 
un’identificazione di nastro standard. 


ID PROPRIETARIO specifica |'1D del proprietario del nastro, 


DATA specifica la data di sessione nel formato corrente (mm/gg/aa, gg/mm/aa, 
oppure aa/mm/gg). 


ORA specifica l'ora. 

CODICE DI STATO specifica i codici di stato per i file sul nastro. 
1 Il file è stato salvato usando la procedura SAVE ALL. 

IDENTIF. FILE specifica il nome del file contenuto sul nastro. 

NUM. SEQ. FILE specifica dove è disposto il file su nastro. 


REC FMT specifica il formato dei record nel file. Questo campo non verrà visualiz- 
zato se il suo codice stato è 3. 


D indica record sbloccati di lunghezza variabile nel formato ASCII. 
DB indica record bloccati di lunghezza variabile in formato ASCII. 
F indica record sbloccati di lunghezza fissa. 
FB indica record bloccati di lunghezza fissa. 
V indica record sbloccati di lunghezza variabile. 
VB indica record bloccati di lunghezza variabile. 
U indica che il formato di record è indefinito. 
Nota: F, FB e V sono supportati sul Sistema/36. 
LUNGHEZZA RECORD specifica (in decimale) il numero dei byte per record 


per un file che ha un formato di record di lunghezza fissa. Per il formato di 


record di lunghezza variabile, il valore indicato è la lunghezza massima del 
record nel file. Questo campo non verrà visualizzato se il suo codice stato è 3. 


LUNGHEZZA BLOCCO specifica (in decimali) il numero di byte in un blocco 
di record per un file che ha un formato di record bloccato, di lunghezza 
fissa. Questo campo non verrà visualizzato se il suo codice stato è 3. 


ALLOCAZIONE RECORD specifica il numero dei record in un file. Per un file con 
record sbloccati, il valore coincide con quello dei record nel file. Per un file bloc- 
cato il valore è il numero massimo di record che il file può contenere. 
| file con codice stato 3 indicheranno l'ampiezza file in blocchi. 


TIPO FILE specifica il tipo del file come indicato da quanto segue: 


APAR FILE indica che il file è stato creato dalla procedura APAR o dal program- 
ma di utilità $REAIDS. 


ARCHIVE indica che il file contiene un membro di cartella che è stato creato 
dalla procedura ARCHIVE o dal programma di utilità $TMSERV. 


COPYFILE indica che il file è stato creato dalla procedura SAVE o val 
programma di utilità $COPY. 

EXCHANGE indica un file diverso degli altri tipi listati. 

Potrebbe essere stato creato dalla procedura TAPECOPY o dal programma di 
utilità $TCOPY. 


LIBRFILE indica un file contenente uno o più membri di libreria che è stato 
creato dalla procedura FROMLIBR o dal programma di utilità $MAINT. 


SAVEFLDR indica un file che contiene una cartella che è stata creata dalla proce- 
dura SAVEFLDR o dal programma di utilità $TMSERV. 


SAVELIBR indica un file che contiene una libreria che è stata creata dalla 
procedura SAVELIBR o dal programma di utilità $MAINT. 


STATO specifica lo stato del file. 


1 indica che il file è stato salvato usando la procedura SAVE ALL. 
2 indica una estensione di cartella 
3 indica che il file non ha identificazione HDR2. 


DATA DI CREAZIONE specifica quando il file è stato creato su nastro. 


DATA DI SCADENZA specifica quando il file su nastro deve scadere (cioè quan- 
do il file non serve più e può essere rimosso). PROTECT indica che il file è 
permanente e che può essere rimosso soltanto inizializzando il nastro. 


MULTIVOLUME specifica se il file continua su un altro nastro. 

NUM. SEQ. specifica il numero della bobina per un file multivolume. SEONUM è 
1 se il primo file sulla bobina non continua su un’altra bobina. È lo stesso su 
tutti i file delia bobina ed è incrementato di 1 se il file continua su un’altra bobi- 
na. Una lettera segue il numero di sequenza. 


A questa lettera può seguire il numero di sequenza 


C indica che il file continua su uno o più nastri. 


L indica che il file è l’ultimo nastro contenente un file di continuazione. 


VOLID specifica l'ID di volume di un file multivolume. VOLID è l'ID di volume della 
prima bobina di un gruppo multivolume. 


SISTEMA DI CREAZIONE specifica il sistema IBM che ha creato il file. 


SET DI NOMI specifica il nome dato ad un’insieme di file salvati utilizzando il co- 
mando SAVE ALL. ; 


NOTA: Un asterisco (*) in qualche campo dell’identificazione file, indica che un ca- 
rattere non visualizzabile è stato trovato nell'identificazione bobina. 
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PROCEDURA CHNGEMEM 


La procedura CHNGEMEM cambia il nome, il sottotipo o il numero di riferimento 
di un membro di libreria. Non può cambiare membri di librerie fornite dalla IBM. i 


La procedura CHNGEMEM esegue il programma di utilità $MAINT. 


CHNGEMEM f nome membro » | SOURCE , |nome libreria 

nome membro ,ALL (S) libreria in uso 

ALL PROC 
(P) 
LOA] 
(0) 
SUBR 
(R) 
LIBRARY 





[nuovo nome | , [sottotipo ] , [| numero di riferimento] 





192 


nome membro specifica il membro di libreria da cambiare. 


nome membro, ALL specifica che i membri di libreria i cui nomi iniziano con 
i caratteri specificati (nome membro) devono-essere modificati. Come nome Xx 
membro è possibile specificare un massimo di 7 caratteri. 


ALL indica che tutti i membri della libreria devono essere modificati. Viene 
emesso un messaggio di errore se questo parametro è specificato con il pa- 
rametro nuovo nome, 


SOURCE o S specifica che devono essere modificati soltanto i membri origine di 
libreria. Se non è specificato alcun parametro, si presume SOURCE. 


PROC o P specifica che devono essere modificati soltanto i membri di procedura 
della libreria. 


LOAD o O specifica che devono essere modificati soltanto i membri oggetto del- 
la libreria, 


SUBR o R specifica che devono essere modificati soltanto i membri della subrou- 
tine di libreria. | 


LIBRARY specifica che devono essere modificati tutti i tipi di membri di libreria 
(SOURCE, PROC, LOAD e SUBR) per il nome di libreria specificato. 


nome libreria specifica la libreria contenente i membri da modificare. Se non vie- 
ne specificato alcun nome di libreria, si presume la libreria corrente. 


nuovo nome specifica il nuovo nome di membro dei membri modificati. Se era 
stato specificato il nome di membro .ALL, il nuovo nome membro deve con- 
tenere lo stesso numero di caratteri specificati nel parametro del nome mem- 
bro .ALL. ! rimanenti caratteri in ciascun nome membro non sono modifi- o, 
cati. 


sottotipo specifica il nuovo sottotipo per i membri modificati: 


ARP Membro auto report RPG 
ARS Membro a risposta automatica 


ASM Membro assembier 


BAP Procedura BASIC (membro origine) 


BAS Membro BASIC 


BGC Diagramma attività grafiche 


BGD Dati grafici gestionali 


BGF Tracciato grafici gestionali 


COB Membro COBOL 


DFU Membro di utilità file di dati 


DTA Membri dati 


FMT Membro tracciato video 


FOR Membro FORTRAN 


ICF Membro procedura Interactive Communications Feature CNFIGICF 


MNU Membro Menu 
MSG Membro Messaggi 


PHL Membro elenco telefonico 


RPG Membro RPG 
SRT Membro Sort 


SSP_ Membro configurazione sistema procedura CNFIGSSP 


UNS Non specificato 


WSU Membro utilità terminale 


numero riferimento specifica il numero di riferimento definito dall'utente di cui 
devono essere modificati i membri. |! valore specificato deve essere numerico 
ed essere compreso nel campo tra 0 e 999999. 


Esempio 1 


Questo esempio cambia in DAY i nomi di tutti i membri che iniziano con PAY. | 
membri si trovano nella libreria denominata PAYROLL. 


CHNGEMEM PAY,ALL,LIBRARY,PAYROLL,DAY 


Esempio 2 


Questo esempio cambia il sottotipo ed il numero di riferimento di un membro 


origine denominato PAYR0O1 


in una libreria denominata PAYROLL. 


sottotipo è SRT con un nuovo numero di riferimento di 123. 


CHNGEMEM PAYOl,SOURCE,PAYROLL, ,SRT,123 


Il nuovo 
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CNFIGICF 


PROCEDURA CNFIGICF 


La procedura CNFIGICF configura o imposta un sottosistema comunicazioni che con- 
siste in un membro linea e un membro sottosistema. Sottosistemi di comunicazio- 
ne sono necessari per l'SSP-ICF (Interactive Communications Feature), il MSRJE, 
l'emulazione unità 3270 e il C&SM. 


Per informazioni sulia definizione di un membro linea, vedere il manuale Using Sy- 
stem Communications. 


Per informazioni su uno specifico sottosistema comunicazioni, vedere il manuale 
appropriato per quel sottosistema. 


La procedura CNFIGICF non ha parametri. 


Esempio 
Per eseguire la procedura CNFIGICF: 


CNFIGICF 


PROCEDURA CNFIGSSP 


La procedura CNFIGSSP configura o imposta il Sistema/36. Per esempio, la si 
usa per fare quanto segue: 


e Definire unità video e stampatrici locali e a distanza. 


e Aggiungere o cancellare programmi su licenza, SSP opzionali e dispositivi SSP. 


e Definirei valori base SSP; ad esempio se devono essere attive la coda lavori 0 
la stampa differita. 


e Specificare le dimensioni del file storico, della VTOC del disco e dell’area di 
lavoro. 


Per informazioni relative agli schermi presentati da CNFIGSSP, vedere il manuale 
Modifica della configurazione del sistema. 


CNFIGSSP 


La procedura CNFIGSSP non ha parametri. 


Esempio 
Per eseguire la procedura CNFIGSSP: 


‘ CNFIGSSP 


PROCEDURA CNFIGX25 


La procedura CNFIGX25 consente di definire la configurazione di rete, la configura- 
zione dei canali logici e la configurazione del circuito virtuale. La procedura CNFIX25 
è descritta nel manuale Using System/36 Communications. 





CNFIGX25 





La procedura CNF1GX25 non ha parametri. 


Esempio 
Per eseguire la procedura CNFIGX25: 


CNFIGX25 


PROCEDURA COBLOAD 


La procedura COBLOAD crea una libreria denominata #COBLIB e vi copia il 
supporto COBOL dai minidisco. COBLOAD copia ulteriore supporto nella libre- 
ria di sistema (#LIBRARY). La procedura COBLOAD può copiare minidischi 
PID (Program Information Department) o minidischi creati dalla procedura COB- 
SAVE. Vedere la Procedura COBSAVE per informazioni sul modo in cui salvare 
il supporto COBOL su minidisco. 


La procedura COBLOAD può modificare il record di configurazione principale con 
il risultato che può non esserci un membro di configurazione corrispondente. Per 
modificare il membro di configurazione per abbinarlo al record di configurazione prin- 
cipale, vedere il manuale Modifica della configurazione del sistema. Occorre nor- 
malmente usare la procedura CNFIGSSP per aggiungere supporto al sistema. È 
possibile usare la procedura COBLOAD per ripristinare il supporto che era stato pre- 
cedentemente salvato dalla procedura COBSAVE. 


Se il COBOL non è in uso corrente sul sistema, prima di eseguire COBLOAD si deve 
utilizzare la procedura TOLIBR per copiare il file COBOL su minidisco nella libreria 


# LIBRARY. 

Se #LIBRARY era stata salvata con il COBOL e poi ripristinata sul Sistema prima 
dell'esecuzione di COBLOAD, non è necessario copiare il file su minidisco COBOL 
con la procedura TOLIBR. . 


COBLOAD 





A1, A2, A3 o A4 indica la preferenza del disco; cioè l’unità disco che viene esa- 
minata per prima alla ricerca di spazio disponibile. Se non è disponibile suf- 
ficiente spazio su quell'unità, vengono esaminate le altre unità (se esistono) 
e #COBLIB è inserito sull'unità disco meno usata. Se non viene specificata 
nessuna locazione ed il sistema ha più di un'unità disco, #COBLIB è inserito 
sull'unità disco meno usata. 


A1 specifica che # COBLIB deve essere inserito sul primo disco, se è disponibi- 
le spazio. 


A2 specifica che # COBLIB deve essere inserito sul secondo disco, se è dispo- 
nibile spazio. 


A3 specifica che # COBLIB deve essere inserito sul terzo disco, se è disponibi- 
le spazio. 


A4 specifica che #COBLIB deve essere inserito sul quarto disco, se è disponi- 
bite spazio. 
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S1, S2 o S3 specifica l'alimentatore a minidischi contenente il primo minidisco 
che deve essere usato. Se non è specificata alcuna posizione di minidisco, si 


assume S1, 
Pasi 


M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidi- 
sco da usare. M1 indica il primo caricatore, M2 indica il secondo caricatore. 
nn è un valore decimale da 01 a 10 che identifica la locazione del minidisco 
nel caricatore. M1 equivale a specificate M1.01; M2 equivale a specificare 
M2.01. 


Esempio 
Creazione di #COBLIB sul disco e copia del supporto COBOL da minidisco. 


COBLOAD 


PROCEDURA COBOL 


La procedura è supportata soltanto per compatibilità con il Sistema/34 della 
IBM. Vedere la Procedura COBOLC per informazioni sulla compilazione di pro- 
grammi COBOL. 


Fonni 
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PROCEDURA COBOLC 


La procedura COBOLC compila ed esegue l'edizione di moduli oggetto di un 
programma origine COBOL. Per. ulteriori informazioni sul COBOL, vedere il ma- 
nuale Programming with COBOL. 


COBOLC nome membro origine, libreria membro origine | , |libreria membro oggetto , 


libreria corrente libreria membro origine 


SM NOPRINT NOXREF NEP 0 


figg ODSM| , |PRINT , |KREF , |[NONEP|_, |num. massimo terminali , 
D 
CRT 


ampiezza file lavoro | , | SOURCE , [DEBUG , IMAP , JOFFSET 
40 NOSOURCE NODEBUG NOMAP NOOFFSET 


OBJECT ; [nome libreria per copie] , [nome libreria sottoroutine] ; 
NOOBJECT 


[nome dizionario cati] , INOMRO 
MRO 


nome membro origine specifica il membro origine da compilare. 


libreria membro origine specifica il nome della libreria che contiene il membro 
origine. Se questo parametro non viene specificato, si presume la libreria cor- 
rente. 


libreria membro oggetto specifica il nome della.libreria che conterrà il membro 
oggetto o il membro di sottoroutine prodotti dalla compilazione. Se la libre- 
ria non è indicata sulla specifica PROCESS o dall'uso di questo parametro, 
si presume la libreria del membro origine. 


NODSM specifica che non deve essere creato alcun membro origine analizzato. 
Se non viene specificato alcun parametro, si presume NODSM. 


DSM specifica che deve essere creato un membro origine analizzato. 


PRINT specifica che deve essere stampata l'emissione del compilatore. Se non vie- 
ne specificato alcun parametro, si presume PRINT.. 


NOPRINT specifica che non deve essere visualizzata o stampata l'emissione del 
compilatore. 


CRT specifica che l'emissione del compilatore deve essere visualizzata. 


XREF o NOXREF specifica se deve essere prodotta una lista di riferimenti in- 
crociati del programma COBOL. Se non è specificato alcun parametro, si 
presume l'opzione indicata nella specifica PROCESS del programma COBOL. 


' 





XREF specifica che deve essere prodotta una lista di riferimenti incrociati. 


NOXREF specifica che non deve essere prodotta alcuna lista di riferimenti 
incrociati. 


NONEP specifica che il programma non è un programma sempre residente in me- 
moria. Se non è specificato alcun parametro, si presume NONEP., 


NEP specifica che il programma è un programma sempre residente in memoria. 
Per ulteriori informazioni sui programmi sempre residenti in memoria, vede- 
re il manuale Concepts and Programmer's Guide, 


num. massimo terminali identifica il programma che viene compilato come un 
programma per terminali richiedenti multipli (MRT) e specifica il numero 
massimo di unità video richiedenti che possono usare ii programma contem- 
poraneamente. ll valore massimo è 99. Se è specificato il valore 0, il pro- 
gramma non è un programma MRT. 


ampiezza file lavoro specifica il numero di blocchi da usare per i file di lavoro del 
compilatore. La dimensione massima dei file di lavoro è 9999. Se questo pa- 
rametro non è specificato, si presumono 40 blocchi. 


SOURCE o NOSOURCE specifica l'opzione di stampa da usare invece dell‘opzio- 
ne di stampa immessa nella specifica PROCESS del programma COBOL. Se 
non viene specificato alcun parametro, viene usata l'opzione indicata nelia 
specifica PROCESS. 


SOURCE indica che il compilatore deve produrre una lista delle specifiche 
origine nel programma COBOL unitamente a qualsiasi messaggio di errore. 


NOSOURCE specifica che il compilatore non deve produrre una lista delle 
specifiche origine nel programma COBOL; devono essere listati soltanto 
messaggi di errore. 


DEBUG o NODEBUG specifica l'opzione di ricerca e correzione degli errori da 
usare invece della corrispondente immessa nella specifica PROCESS del pro- 
gramma COBOL, Se non è specificato alcun parametro, è usata l'opzione in- 
dicata nella specifica PROCESS. 


DEBUG specifica che il compilatore deve usare la funzione di ricerca e corre- 
zione di errori COBOL. 


NODEBUG specifica che il compilatore non deve usare la funzione di ricerca 
e correzione degli errori COBOL. 


MAP o NOMAP specifica se deve essere usata l'opzione di mappa della Data Di- 
vision del programma COBOL. invece dell'opzione immessa nella specifica 
PROCESS del programma COBOL. Se non viene specificato alcun parame- 
tro, viene usata l'opzione indicata nella specifica PROCESS. 


MAP specifica che il compilatore deve eseguire una mappa della Data Divi- 
sion del programma, 


NOMAP specifica che ii compilatore non deve eseguire un mappa della Data 
Division del programma. 


OFFSET o NOOFFSET specifica se deve essere usata l'opzione di mappa della 
Procedure Division del programma COBOL invece dell'opzione immessa nella 
specifica PROCESS del programma COBOL. Se non viene specificato alcun 
parametro, viene usata l'opzione indicata nella specifica PROCESS. 


199 


OFFSET specifica che il compilatore deve eseguire la mappa della Procedure 
Division del programma. 


NOOFFSET specifica che il compilatore non deve eseguire la mappa della 
Procedure Division del programma. 


OBJECT o NOOBIECT specifica se il compilatore deve produrre un membro ogget- 
| to che deve essere sottoposto a edizione di moduli oggetto. Se non viene spe- 
cificato alcun parametro, viene usata l'opzione indicata nella specifica PRO- 

CESS del programma COBOL. 


| OBJECT specifica che il compilatore deve produrre un membro oggetto. 
| i NOOBJECT specifica che il compilatore non deve produrre un membro oggetto. 


nome libreria per copia specifica la libreria in cui cercare quando si incontra una 
specifica COBOL COPY. Vedere il manuale Programming with COBOL per 
ulteriori informazioni. Se questo parametro non viene specificato, si presume 
la libreria indicata nella specifica PROCESS del programma COBOL. 


nome libreria sottoroutine specifica la libreria che contiene una o più sottorouti- 
ne che devono essere incluse nel programma compilato. Se questo parametro 
non viene specificato, si presume la libreria indicata nella specifica PROCESS 
del programma COBOL. 


nome dizionario dati specifica il dizionario contenente la definizione comunicazione 
file da usarsi durante la compilazione. 


MRO o NOMRO specifica se il compilatore è da usarsi con strutture overlay resi- 
denti in memoria. Questo parametro può essere usato per sostituire l'opzione 
indicata nella specifica PROCESS del programma COBOL. Se non viene speci- 
ficato alcun parametro, viene assunto NOMRO. 


MRO specifica se il compilatore viene usato con strutture overlay residenti in 
memoria. 

| NOMRO specifica che il compilatore non viene usato con strutture overlay re- 
sidenti in memoria, 


Esempio 


Questo esempio mostra come compilare un programma COBOL. ll membro origi- 
ne è denominato PAYROLL e si trova nella libreria denominata TESTLIBR. 
Il programma compilato deve essere denominato PAYROLL e deve essere inserito 
in una libreria denominata PAYLIBR. Se si trovano errori durante la compilazio- 
ne, deve essere creato un membro origine analizzato. 


COBOLC PAYROLL,TESTLIB,PAYLIB,DSM,,XREF,,, S0URCE,DEBUG 


PROCEDURA COBOLCG 


Questa procedura è supportata soltanto per compatibilità con il Sistema/34 IBM. 
Vedere la Procedura COBOLC per informazioni sulla compilazione di programmi 
COBOL. Vedere la Specifica OCL LOAD e la Specifica OCL RUN per informa- 
zioni sull'esecuzione dei programmi. 


PROCEDURA COBOLG 


Questa procedura è supportata soltanto per compatibilità con il Sistema/34 della 
IBM. Vedere la Specifica OCL LOAD e la Specifica OCL RUN per informazioni 
sull'esecuzione dei programmi. 
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PROCEDURA COBOLONL 


La procedura COBOLONL consente di sviluppare un programma COBOL. Con es- 
sa è possibile creare un nuovo programma o effettuare numerose modifiche ad un 


programma esistente. La procedura COBOLONL mostra una serie di schermi che 
consentono di immettere, compilare e modificare programmi COBOL. 
Per ulteriori informazioni sui COBOL, vedere i! manuale Programming with 
COBOL. 
COBOLONL 
La procedura COBOLONL non ha parametri. 
Esempio 
Per sviluppare un programma COBOL immettere: 
COBOLONL 
PROCEDURA COBOLP 
La procedura COBOLP fa sì che venga visualizzato un menù consentendo di sele- 
Ci zionare le opzioni che si desiderano eseguire. E’ possibile immettere, compilare o 
modificare programmi COBOL. 
Per ulteriori informazioni sul COBOL, vedere il manuale Programming with 
COBOL. 
COBOLP 


La procedura COBOLP non ha prametri, 


Esempio 
Questo esempio mostra come visualizzare il menu COBOLP. 


COBOLP 


ni 
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PROCEDURA COBSAVE 
La procedura COBSAVE ricopia su minidisco il supporto COBOL. Viene copiato 
il supporto COBOL dalle librerie #COBLIB e #LIBRARY, E’ possibile usare la 
Procedura COBLOAD per caricare il supporto COBOL dal minidisco. Il minidisco 


destinato a contenere la copia salvata, deve avere come ID di volume PPCOBL e 
deve essere inserito nell’alimentatore S1. 


COBSAVE 


La procedura COBSAVE non ha parametri. 


Esempio 
Copia del supporto COBOL su minidisco. 


COBSAVE 
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COBSDA 


PROCEDURA COBSDA 


La procedura COBSDA avvia la procedura SDA. Vedere il manuale Guida alla De- 
finizione dei Tracciati Video per informazioni sui tracciati video e sul modo in 
cui usare SDA. 


Vedere il manuale Programming with COBOL per ulteriori informazioni su questa 
procedura e sul COBOL. 


La procedura COBSDA non ha parametri. 


Esempio 
Per avviare la procedura COBSDA immettere: 


COBSDA 
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PROCEDURA COBSEU 


La procedura COBSEU avvia la procedura SEU. Ciò consente di creare o modifi- 
care un programma o procedura COBOL. Vedere sul manuale Programming with 
COBOL per ulteriori informazioni su questa procedura e sul COBOL. Per ulterio- 
ri informazioni sul SEU vedere il manuale Programma di Utilità per l'immissione 


di dati origine (SEU). 


COBSEU nome membro,|S|,|membro formato seu, [1ugnezza specifica|, 
P| (FSEGXTRA 


nome libreria 
libreria corrente 





nome membro specifica il membro origine o la procedura che si vuole creare o 
modificare. ° ° 


S specifica un membro origine COBOL. Se non viene specificato alcun parametro, 
si presume S. 


P specifica un membro di procedura di libreria. 


membro formato seu specifica il nome del membro di tracciato video SEU da 
usare per correggere le specifiche origine. Se non viene specificato alcun no- 
me di formato, si presume #SE@ XTRA. 


lunghezza specifica specifica la lunghezza di ciascuna specifica di procedura o ori- 
gine. Può trattarsi di qualsiasi numero decimale da 40 a 120. Se il membro 
esiste, si assume la lunghezza della specifica del membro. Se il membro viene 
creato, i valori che è possibile specificare e i valori che sono assunti da 
COBSEU se non viene indicata la lunghezza della specifica, sono i seguenti: 


Lunghezza specifica Lunghezza specifica 
Tipo membro ammessa assunta 


da 80 a 96 
da 40 a 120 





nome libreria specifica la libreria che contiene o conterrà il membro di libreria 
che viene modificato o creato. Se non viene specificata alcuna libreria, si 
presume la libreria corrente. 


Esempio 


Questo esempio mostra come avviare COBSEU per creare o modificare una pro- 
cedura denominata PAYROLL. La procedura è contenuta nella libreria corrente. 


COBSEU PAYROLL,P 


PROCEDURA COMPRESS 


La procedura COMPRESS riunisce tutto lo spazio su disco inutilizzato nell’ambito 
dell’area dell'utente. Ciò consente di creare sul disco spazio a disposizione per file, 
librerie, e cartelle più grandi, riunendo le aree più piccole inutilizzate. Quest'area 
può essere disposta nei numeri di blocco alti o bassi per ciascuna unità disco. 


Per i sistemi con una sola unità disco, A1 si riferisce a quell’unità. Per i sistemi 
con più unità disco, A1 si riferisce alla prima unità; A2 si riferisce alia seconda, 
A3 si riferisce alla terza e A4 si riferisce alla quarta. 


La procedura COMPRESS può essere eseguita da qualsiasi unità video comandi, 
dalla coda lavori, da SSP-ICF o richiamata usando la specifica OCL EVOKE. 


Quando la procedura COMPRESS è in esecuzione, sono ammesse le seguenti 
funzioni: 


e Operatori collegati al sistema (ma che non eseguono programmi) 
e Terminali a distanza 

e SDLC 

®  Sottosistemi SSP-ICF 

e Chiamata automatica 


Quantunque la procedura COMPRESS non richieda un sistema dedicato, tuttavia 
COMPRESS impedisce di: 


e Immettere dati o comandi 
e  Collegarsi sull'unità video 
e Passare al modo console sulla console di sistema o su una sottoconsole. 


Vedere la Procedura #STRTUPI1 per informazioni sulla compressione del disco 
come parte del caricamento del programma iniziale (IPL). 


La procedura COMPRESS esegue il programma di utilità $FREE. Il tempo che 
il sistema impiega per eseguire la procedura COMPRESS è influenzato dalla di- 
mensione della memoria centrale disponibile per l'esecuzione -del programma. La 
procedura COMPRESS usa automaticamente quanto più spazio possibile. 


Nota: Se nella specifica FILE per un file spostato dalla procedura COMPRESS 
era specificato il parametro LOCATION, la locazione specificata non è più cor- 
retta dopo che la procedura COMPRESS ha spostato il file. Usare la procedura 
CATALOG per visualizzare le entrate VTOC per determinare le nuove locazioni 
dei file. 


COMPRESS FREELOW 
LOW 


FREEHIGH 
HIGH 
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ALL specifica che devono essere compresse tutte le unità disco. Se si dispone sol- 


A1 


A2 


A3 


A4 


tanto di un'unità disco (A1), lo spazio libero deve essere riunito in corrispon- 
denza dei numeri di blocco più alti (FREEHIGH). 


Disco A1 





Spazio libero 


Se si dispone di due unità disco (A1, A2) lo spazio libero deve essere riunito 
in corrispondenza dei numeri di blocco più elevati {(FREEHIGH) per A1 ed 
in corrispondenza dei numeri di blocco più bassi (FREELOW) per A2. 


Disco A1 Disco A2 





Spazio libero 


Se si dispone di tre unità disco (A1, A2, A3), lo spazio libero deve essere 
riunito in corrispondenza dei numeri di blocco più alti (FREEHIGH) per A1 
e A2 ed in corrispondenza dei numeri di blocco più bassi (FREELOW) per 
A3. 


Disco A1 Disco A2 Disco A3 





Spazio libero Spazio libero 


Se si dispone di quattro unità disco (A1, A2, A3, A4) lo spazio libero deve 
essere riunito in corrispondenza dei numeri di blocco più elevati (FREE- 
HIGH) per A1 e A3 ed in corrispondenza dei numeri di blocco più bassi 
(FREELOW) per A2 e A4. 


Disco A1 Disco A2 Disco A3 Disco A4 





Spazio libero Spazio libero 


Se non sono specificati parametri (se è specificato soltanto COMPRESS), si 
presume COMPRESS ALL. 


specifica che deve essere compressa soltanto la prima unità disco. Se non è 
specificato alcun parametro, si presume FREEHIGH, 


specifica che deve essere compressa soltanto la seconda unità disco. Se non è 
specificato un secondo parametro, si presume FREELOW. A2 non è valido a 
meno che il sistema non abbia almeno due unità disco. 


specifica che deve essere compressa soltanto la terza unità disco. Se non è 
specificato il secondo parametro, si presume FREELOW. A3 non è valido a 
meno che il sistema non abbia almeno tre unità disco. 


specifica che deve essere compressa soltanto la quarta unità disco. Se non è 
specificato il secondo parametro, si presume FREELOW. A4 non è valido a 
meno che il sistema non abbia quattro unità disco. 


FREELOW o LOW specifica che lo spazio libero sull'unità disco specificata deve 
essere riunito nei numeri di blocchi inferiori (all’inizio) dell’unità disco, E’ 
possibile usare questo parametro quando occorre aumentare la dimensione 
della libreria di sistema (#LIBRARY) e occorre spostare uno o più file o li- 
brerie dalla #LIBRARY. 


FREEHIGH o HIGH specifica che lo spazio libero sull'unità disco specificata de- 


ve essere riunito in corrispondenza dei numeri di blocco più elevati (la fine) 
dell'unità disco. 


Esempio 1 
Per comprimere lo spazio libero sul disco: 


COMPRESS 


Esempio 2 
Per comprimere tutte le unità disco e far sì che lo spazio libero venga riunito 
in corrispondenza dei numero di blocco alti di ciascuna unità, usare quanto 


segue: 


COMPRESS ALL,FREEHIGH 


Esempio 3 


Per comprimere l'unità disco A1 e far sì che lo spazio libero venga raccolto in 
corrispondenza dei numeri di blocco alti: 


COMPRESS Al,FREEHIGH 
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PROCEDURA CONDENSE 


La procedura CONDENSE raccoglie in una sola area tutto lo spazio inutilizzato nel- 
l'ambito di una libreria o cartella. Ciò consente di creare spazio a disposizione per 
altri membri riunendo le aree inutilizzate più piccole. Lo spazio inutilizzato è riunito 
all'estremità della libreria o della cartella. Inoltre se la libreria ha un’estensione, l’e- 
stensione è combinata con la libreria stessa (se la libreria ha spazio sufficiente). Un'e- 
stensione di libreria è un’area sul disco che contiene membri di libreria che non tro- 
verebbero posto nella libreria originale. 


Quando viene eseguita la procedura CONDENSE, nessuna unità video o nessun al- 
I tro lavoro può usare la libreria o la cartella specificata. Se viene compiuto un tenta- 
tivo di eseguire la procedura CONDENSE per una libreria che viene usata da un altro 
lavoro, viene visualizzato un messaggio di errore e la procedura CONDENSE non 
viene eseguita. Una volta che CONDENSE inizia l'esecuzione, nessun altro lavoro 
| può usare la libreria o cartella specificata fino a che CONDENSE non è terminata. 


La libreria di sistema (#LIBRARY) non può essere condensata mentre: 
e Vengono eseguiti altri lavori 
e Sonoabilitati i sottosistemi SSP-ICF 


e E'abilitata una linea di comunicazione. 


E' possibile usare i comandi di controllo STATUS USERS e STATUS SYSTASK 
a per determinare se una qualsiasi di queste condizioni è vera. 


Vedere la Procedura #STRTUPI1 per informazioni sulla condensazione della libre- 
ria di sistema come parte del caricamento del programma iniziale (IPL). 


La procedura CONDENSE può anche riorganizzare una cartella. | membri di cartella 
vengono riuniti all’inizio della cartella, per rendere il numero delle estensioni della 
cartella il più piccolo possibile. (Questo aumenta il rendimento del sistema perchè 
la cartella gestisce in modo migliore lo spazio su disco). La procedura CONDENSE 
rende la cartella il più piccolo possibile. Ciò equivale all'utilizzo della procedura 
ALOCFLDR con specificato il parametro MIN. 


La procedura CONDENSE esegue il programma di utilità $MAINT. Se è specificato 
il parametro FOLDER, esegue il programma di utilità $TMSERV. 


CONDENSE Pe libreria 


libreria corrente sl FOLDER 
nome cartella 
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nome libreria specifica la libreria da condensare. Se non è specificato un nome di 
libreria, si presume la libreria corrente. 


nome cartella specifica la cartella da riorganizzare. Se è specificato il parametro 
FOLDER, questo nome deve essere indicato. 


FOLDER specifica che la cartella indicata nel primo parametro deve essere 
riorganizzata. 


Esempio 1 
Per condensare i membri nella libreria di sistema: 


CONDENSE #LIBRARY 


Esempio 2 
Per condensare i membri nella libreria corrente denominata MYLIB: 


CONDENSE 


Esempio 3 
Per riorganizzare una cartella denominata MYFLDR: 


CONDENSE MYFLDR, FOLDER 
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PROCEDURA COPYDATA 


La procedura COPYDATA copia un file di dati su disco su un altro file su disco. 
Durante l'operazione di copia, la procedura COPYDATA può: 


e Creare un file copiato nella stessa organizzazione di file o in un'organizzazio- 
ne di file diversa. | file possono essere sequenziali, diretti o a indice. 


e Onmettereo includere record specificati. 

e Rimuovere i record cancellati. 

e Modificare ia lunghezza di record, 

e Riorganizzare i record di dati in un file a indice, 

e Limitare il numero dei record di immissione da copiare. 


La procedura COPYDATA può essere utilizzata per copiare file su un sistema remo- 
to. Vedere il manuale Distributed Data Management Guide. 


La procedura COPYDATA può elaborare un file che viene usato da un altro lavo- 
ro sul sistema, posto che la specifica OCL FILE di quel lavoro indichi DISP- 
SHRRR o DISP-SHRRM; vedere la Specifica OCL FILE (per i file su disco) a 
pag. 000 per ulteriori informazioni sulla condivisione dei file. La procedura 
COPYDATA non può copiare file a indice alternativi. 


La procedura COPYDATA esegue il programma di utilità $COPY. 


. 


COPYDATA nome vecchio file, |mggaa], nome nuovo file,f, 


AI 
AQ 
A3 
AL 


ggmmaa, BLOCKS,blocchi 
aammgg RECORDS,record 


,|L| .| NOREORG| , | INCLUDE , [posizione] | EQ], 
J| | REORG OMIT NE 

LT 

LE 


numero blocco GT 


GE 


|'ceratteri'] , [Lunghezza record] 5 fem. massimo record| s| SAME|, 


NODUPKE 


[posizione chiave lunghezza chiave | , a | 
xv 
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nome vecchio file specifica il file da copiare, lì file può avere qualsiasi organizza- 


zione. In ogni caso non è possibile copiare file a indice alternativi. Vedere la 
Procedura BLDINDEX per ulteriori informazioni sugli indici alternativi. 


mmggaa, ggmmaa o aammgg specifica la data di creazione deli file da copiare. La 


data, se specificata, deve essere nel formato della data di sessione; usare il 
comando STATUS SESSION per determinare il formato della data di sessio- 
ne. Se non è specificata una data ed esiste più di un file con lo stesso nome, 
viene copiato il file con la data più recente. 


nome nuovo file specifica il nome del nuovo file contenente i record copiati dal 


file di immissione. Il primo carattere del nome file deve essere alfabetico (da 
A a Z, #, @, 0 $). Il nome file può essere qualsiasi combinazione di caratte- 
ri (numerici, alfabetici e speciali) salvo le virgole (,), gli apici (’) e gli spazi 
vuoti. ll numero di caratteri in un file non deve superare 8. 


BLOCKS o RECORDS specifica la dimensione del nuovo file. Se non è specifica- 


to né BLOCKS né RECORDS, la dimensione dei nuovo file è la stessa del 
vecchio file. Se vengono variati l’organizzazione e/o la lunghezza del record 
dei file, it nuovo file è reso abbastanza ampio per contenere il numero totale 
di record nel vecchio file. 


BLOCKS specifica il numero dei blocchi di file su disco da allocare {e cioè riser- 


vare) per il nuovo file. Un blocco su disco contiene 2560 byte. 


blocchi specifica il numero di blocchi necessari per il nuovo file, che non può 
essere maggiore del massimo configurato. 


E’ possibile usare la procedura CATALOG per determinare il numero di bloc- 
chi su disco disponibili per un file. Non è possibile creare un file se esso con- 
tiene più di 16.777.200 record. 


RECORDS specifica il numero di record da allocare (e cioè riservare) per il nuo- 


AI, 


vo file. Se si specifica RECORDS, SSP alloca il numero necessario di blocchi 
per contenere quei record. Lo spazio riservato per il nuovo file è arrotondato 
al successivo blocco, facendo in modo che il file contenga almeno il numero 


di record specificato. L'unità più piccola che è possibile riservare per un file 
su disco è un blocco. 


record specifica il numero di record da allocare per il nuovo file, che non 
può essere superiore a 8.000.000. 


A2, A3 o A4 indica la preferenza del disco; cioè l’unità disco che viene esa- 
minata per prima nella ricerca di spazio disponibile. Se non è disponibile 
sufficiente spazio su quell'unità vengono esaminate le altre unità (se esistono) 
ed il file viene inserito sull'unità disco meno usata. Se non è specificata alcu- 
na locazione, o si presume la locazione preferita sul vecchio file. 


A1 specifica che la locazione preferenziale del file su disco è sul primo disco. 
Se è disponibile spazio, 1'SSP inserisce il file sul primo disco. 


A2 specifica che la locazione preferenziale del file su disco è sul secondo di- 
sco. Se è disponibile spazio, l’ SSP inserisce il file sul secondo disco. 


A3 specifica che la locazione preferenziale del file su disco è sul terzo disco. 
Se è disponibile spazio, il sistema inserisce il file sul terzo disco. 


A4 specifica che la locazione preferenziale del file su disco è sul quarto disco. 
Se è disponibile spazio, il sistema inserisce il file sul quarto disco. 


numero blocco specifica il numero del primo blocco nel nuovo file. E' possibile 
specificare fino a 6 cifre. E’ inoltre possibile usare la procedura CATALOG 
per determinare dove sono disponibili blocchi di spazio su disco. Usare il 
parametro del numero di blocco con cautela in quanto le procedure COM- 
PRESS e RESTORE possono provocare lo spostamento di un file dal nume- 
ro di blocco specificato ai momento della creazione del file. 


T specifica che il nuovo file deve essere un file residente. Un file residente è so- 
litamente usato più di una volta. L'area del disco contenente un file resi- 
dente diventa disponibile per un altro file dopo che viene usata la procedura 
DELETE per rimuovere il file dal disco. Per ulteriori informazioni sui file 
residenti, vedere la Specifica OCL FILE (per i file su disco). 


Se non è specificato alcun parametro, viene assunto T. 


J specifica che il nuovo file deve essere un file di lavoro. Il file di lavoro può es- 
sere usato soltanto dai passi di lavoro successivi in un lavoro. Il file di favoro 
è definito soltanto nell’ambito del lavoro ed è cancellato da SSP quando il 
lavoro termina. 


Una volta che è creato un file di lavoro, i passi successivi nel lavoro possono 
fare riferimento al file usando la specifica OCL FILE che contiene i parame- 
tri RETAIN-S o RETAIN-J o non specificando un parametro RETAIN. Se 
non viene specificato un parametro RETAIN, oppure se viene specificato 
RETAIN-J, il file esiste come file di lavoro per i passi dì lavoro successivi. Se 
viene specificato RETAIN-S come file di lavoro, il file di lavoro diventa un 
file temporaneo ed è rimosso dal disco quando il passo di lavoro termina. 
Per ulteriori informazioni sui file di lavoro, vedere ia Specifica OCL FILE 
{per i file su disco). 


NOREORG specifica che qualsiasi record cancellato non deve essere rimosso nel 
processo di copia. Inoltre i record in un file a indice devono essere, nel nuo- 
vo file, nella stessa posizione che avevano nel file da copiare. | record can- 
cellati saranno comunque rimossi quando vengono specificati dei parametri 
addizionali per i file a indice o sequenziali. Se non viene specificato alcun 
parametro, si presume NOREORG. 


REORG specifica che qualsiasi record cancellato nel file da copiare deve essere 
rimosso quando il file è copiato nel nuovo file. In ogni caso i record cancel- 
lati sono sempre copiati per i file diretti. Se il file da copiare è un file a in- 
dice, i record del vecchio file sono letti sequenzialmente per chiave. 


INCLUDE o OMIT specifica se record specifici nel file da copiare devono essere 
inclusi o omessi dal nuovo file. 1 parametri INCLUDE e OMIT lavorano con 
i parametri: posizione, EO, NE, LT, GT, LE, GE e ‘caratteri’ Se sono spe- 
cificati soltanto ‘caratteri’ o posizione, si presumono INCLUDE e EQ. 


posizione indica, per ciascun record ii primo carattere da contrapporre ai carat- 
teri di confronto. La posizione può essere qualsiasi numero da 1 a 4.086. Se 
non è specificata alcuna posizione, viene paragonata ogni posizione nel 
record con i caratteri di confronto fino a che la condizione non viene soddi- 
sfatta. 
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EO 


NE 


LT 


LE 


GT 


GE 


specifica che se i caratteri nei record indicati da posizione sono gli stessi ca- 
ratteri di confronto, il record deve essere incluso 0 omesso dal nuovo file, 


specifica che se i caratteri nei record indicati da posizione non sono gli stessi 
caratteri di confronto, il record deve essere incluso o omesso dal nuovo file. 


specifica che se i caratteri nei record indicati da posizione sono minori dei 
Caratteri di confronto, il reconrd deve essere incluso 0 omesso dal nuovo file. 


specifica che se i caratteri nei record indicati da posizione sono minori o 
uguali ai caratteri di confronto, il record deve essere incluso o omesso dal 
nuovo file, 


specifica che se i caratteri nei record indicati da posizione sono maggiori dei 
caratteri di confronto, il record deve essere incluso o omesso dal nuovo file. 


specifica che se i caratteri nei record indicati da posizione sono maggiori o 
uguali ai caratteri di confronto, il record deve essere incluso o omesso dal 
nuovo file. 


‘caratteri’ specifica i caratteri di confronto. E’ possibile specificare fino a 30 ca- 


ratteri che devono essere racchiusi tra apici (’). E’ possibile includere spazi 
in bianco e virgole (,), ma gli apici non possono essere specificati come dati. 


lunghezza record specifica la lunghezza di record nel nuovo file e può essere 


qualsiasi numero da 1 a 4.096. Se questo parametro non viene immesso, 
come lunghezza di record del nuovo file viene usata la lunghezza di record 
del file da copiare. 


Se la lunghezza di record del vecchio file è minore della lunghezza del record 
specificata per il nuovo file, le posizioni di record addizionali nel nuovo file 
sono riempite con spazi in bianco. Se la lunghezza di record del vecchio file 
è maggiore di quella specificata per il nuovo file, le posizioni in più sono 


troncate. Se il nuovo file è un file a indice e il campo chiavi viene troncato, 
viene visualizzato un messaggio di errore. 


num. massimo record specifica il numero totale di record da copiare nel nuovo 


file. E’ possibile immettere qualsiasi numero maggiore di 0. Notare che SSP 
non può creare un file che contiene più di 16.777.200 record, 


SAME specifica che il nuovo file deve avere la stessa organizzazione del file da 


copiare. Se non è specificato alcun parametro si presume SAME. 


S specifica che il nuovo file deve essere organizzato come file sequenziale. 


I specifica che il nuovo file deve essere organizzato come file a indice, 


D specifica che il nuovo file deve essere organizzato come un file diretto. 


posizione chiave specifica la posizione iniziale della chiave per il nuovo file. La 


posizione della chiave deve essere specificata se il nuovo file deve essere a 
indice ma il vecchio file non era organizzato come tale. La posizione della 
chiave può essere qualsiasi numero da 1 a 4.096. Se non è specificato un 
valore, si assume la posizione di chiave per il file a indice che viene copiato. 
L'intera chiave, definita dalla posizione e dalla lunghezza, deve essere all’in- 
terno del record. Se viene immessa la posizione della chiave deve essere im- 
messa anche la lunghezza e viceversa. 


lunghezza chiave specifica la lunghezza della chiave per il nuovo file. La lunghezza 
di chiave deve essere specificata se il nuovo file deve essere un file a indice 
ma il vecchio non era organizzato come tale. La lunghezza di chiave può essere 
qualsiasi numero da 1 a 120. Se non è specificato un valore, si presume la lun- 
ghezza di chiave per il file a indice che viene copiato. L'intera chiave, definita 
dalla posizione e dalla lunghezza, deve essere all’interno del record, Se viene 
immessa la posizione della chiave, deve essere immessa anche la lunghezza e 


viceversa. 


DUPKEY specifica che nel file ad indici che viene creato devono essere ammesse 
chiavi doppie. Se il file che viene creato non è un file ad indici, questo para- 
metro è ignorato. Se questo parametro non è specificato, l'attributo del file 
di immissione sarà l'attributo del file di emissione, 


NODUPKEY specifica che nel file ad indici che viene creato non sono ammesse 
Chiavi doppie. Se il file che viene creato non è del tipo ad indici, questo pa- 
rametro è ignorato. Se questo parametro non è specificato, l'attributo del 
file di immissione sarà l'attributo del file di emissione. 
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Esempi 


Gli esempi che seguono sono basati su un file denominato FILE1 che contiene 
cinque record. ll file è a indice, la lunghezza del record è 60 e la chiave per l’in- 


dice è nelle posizioni da 1 a 4. 


Nome file Data file OrganizzazioneLung.chiavePos.chi. Lunghezza record Unità 

FILELl 15/09/83 INDEXED L 1 60 Fl 
Losa edOene aueQ0re o atea e HO LO 00 

KEY - 0001 

LINE NO - 1 0001SAMPLE DATA 4512 - 18TH AVE NW NEW YORK, NY 

KEY - 0002 

LINE NO - 1 0002MORE SAMPLE DATA 100 - MAIN ST N CHICAGO, IL 

KEY - 0003 

LINE NO - 1 0003CUSTOMER 1 3214 - STH ST NE NEW YORK, NY 

KEY - 000 

LINE NO - 1 O0O04CUSTOMER 2 201% - NTH ST NE NEW YORK, NY 

KEY - 0005 

LINE NO - l O005CUSTOMER 3 3018 - STH ST NE CHICAGO, IL 


TOTAL RECORDS PRINTED - 5 


Esempio 1 


Questo esempio mostra come copiare FILE? per produrne una copia esatta, 


FILE2. 


COPYDATA FILEl,,FILE2 


FILE2 contiene ora i seguenti record: 


Nome file Data file 
FILE2 15/09/83 INDEXED 4 1 

Lica aelO5ane ea cara deo reirntaaoi 
KEY - 0001 
LINE NO - 1 0001SAMPLE DATA 4512 - 18TH AVE NW 
KEY - 0002 
LINE NO - 1 0002MORE SAMPLE DATA 100 - MAIN ST N 
KEY - 0003 
LINE NO - 1 0003CUSTOMER 1 3215 - STH ST NE 
KEY - 000 
LINE NO - 1 O004CUSTOMER 2 2014 - KTH ST NE 
KEY - 0005 
LINE NO - 1 O0OSCUSTOMER 3 3018 - STH ST NE 


TOTAL RECORDS PRINTED - 5 
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OrganizzazioneLung. chiavePos.chi. Lunghezza record Unità 
Fl 


60 


1050, 00% 


NEW YORK, NY 


CHICAGO, IL 


NEW YORK, NY 


NEW YORK, NY 


CHICAGO, IL 


10.60... 


Data 
15/09/83 


«r070600. 


Data 
15/09/83 


voel0..0.. 


Ora 


10.51.47 


10080... 


Ora 


‘10,49.55 


s000025 18 


Pagina - 1 
00900000 01100 
Pagina - 1 
cina Poca e 100 


Nome file 
FILE3 


Esempio 2 


KEY - CUSTOMER 1 


LINE NO — 


KEY - CUSTOMER 2 


LINE NO - 


KEY - CUSTOMER 3 


LINE NO - 


Data file OrganizzazioneLung.chiavePos.chi. Lunghezza record Unità Data Ora 

15/09/83 INDEXED 20 5 60 F1 15/09/83 10.54.24 
Line eni lis ae asa ape 30 ia ii: erre at O TO Bot 

l O003CUSTOMER 1 321% - STH ST NE NEW YORK, NY 

l O004CUSTOMER 2 2014 — 4TH ST NE NEW YORK, NY 

L O00SCUSTOMER 3 3018 - STH ST NE CHICAGO, IL 


Questo esempio mostra come copiare un file a indice denominato FILE1 e creare 
un nuovo file denominato FILE3. Ii nuovo file è a indice e la chiave deve essere 
nelle posizioni da 5 a 24, 


COPYDATA FILEl,,FILE3,,:3333333331,D320 


FILE3 contiene ora i seguenti record: 


KEY - MORE SAMPLE DATA 
1 OO0O2MORE SAMPLE DATA 100 - MAIN ST N CHICAGO, Il 


LINE NO - 


KEY - SAMPLE DATA 
2 0001SAMPLE DATA 3512 - 18TH AVE NW NEW YORK, NY 


LINE NO — 


TOTAL RECORDS PRINTED - 5 


Esempio 3 


Questo esempio. mostra come rimuovere record cancellati da un file sequenziale 
dal quale è possibile cancellare i record denominato FILEA. Le fasi intraprese, 
sono le seguenti: 


1. file FILEA è copiato in un file temporaneo denominato TEMP ed è rior- 
ganizzato usando ia procedura COPYDATA. 


2. FILEA è rimosso dal disco usando la procedura DELETE. 


3. Il file temporaneo viene quindi ridenominato FILEA usando la procedura 
RENAME. 


Vengono usate le seguenti procedure: 


COPYDATA FILEA,,TEMP,,,,,REORG 
DELETE FILEA,F1 
RENAME TEMP,FILEA 


Pagina - 1 
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Esempio 4 


L'esempio mostra come copiare nel nuovo file soltanto i record che contengono 
i caratteri ‘CHICAGO, IL’ iniziando dalla posizione 45. 


COPYDATA FILEl,,FILE,,,,, INCLUDE,k5,EQ,'CHICAGO, IL' 


FILEA contiene ora i seguenti record: 


Nome file Data file OrganizzazioneLung.chiavePos.chi. Lunghezza record Unità Data Ora Pagina - 1 
FILE 15/09/83 INDEXED i y 1 60 Fl 15/09/83 10.59.20 

l'ira sio elena a ti ei O i a TO orata a IO pr  100, 
KEY - 002 
LINE NO - 1 0002MORE SAMPLE DATA 100 - MAIN ST N CHICAGO, IL 
KEY - 0005 
LINE NO —- 1 OOO0SCUSTOMER 3 3018 - 5TH ST NE CHICAGO, IL 


TOTAL RECORDS PRINTED - 2 


Esempio 5 
Questo esempio mostra come copiare soltanto quei record che contengono le 
parole ‘SAMPLE DATA’. Notare che poiché non è specificata alcuna posizione, il 
record viene copiato, qualunque sia la posizione in cui la frase compare. 


COPYDATA FILEl,,FILE5,,,,,,INCLUDE,,EQ,'SAMPLE DATA! 


FILES contiene ora i seguenti record: 


Nome file Data file OrganizzazioneLung.chiavePos.chi. Lunghezza record Unità Data Ora Pagina -— 1 
FILES 15/09/83 INDEXED ù 1 60 F1 15/09/83 11.01.19 

L.vr e 0010000 000200000 000300000 see UO goa 0050000 0060 TO BO 90 + 100 
KEY - 0001 
LINE NO - 1’ O0001SAMPLE DATA - 4512 - 18TH AVE NW NEW YORK, NY 
KEY - 0002 : 
LINE NO - 1 0002MORE ‘SAMPLE DATA 100 - MAIN ST N CHICAGO, IL 


TOTAL RECORDS PRINTED - 2 
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ST 


STA 


Esempio 6 


Questo esempio mostra come copiare solo quei record che hanno un valore mag- 


giore di ‘0002’ nelle posizioni da 1 a 4. 


COPYDATA FILE1l,,FILE6,,,,, ,INCLUDE,1,GT,'0002' 


FILE6 contiene ora i seguenti record: 


Nome file Data file OrganizzazioneLung.chiavePos.chi, Lunghezza record Unità 
FILE6 15/09/83 INDEXED ù L 60 Fl 
led0 zan at Orco ie Fe alia 910 PAN FIDI sO 

KEY - 0003 

LINE NO - 1 0003CUSTOMER 1 321% - STH ST NE NEW YORK, NY 

KEY - 000 

LINE NO - 1 O00L4CUSTOMER 2 201% - LTH ST NE NEW YORK, NY 

KEY - 0005 

LINE NO - 1 OO005CUSTOMER 3 3018 - 5TH ST NE CHICAGO, IL 


TOTAL RECORDS PRINTED - 3 


Data 
15/09/83 


70... 


Ora 
11.02.54 


ssa o 
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| PROCEDURA COPYDIAG 


La procedura COPYDIAG copia un singolo minidisco diagnostico {microprogramma). 
Inserire il minidisco di immissione in S1 e quello di emissione in $2. Una volta letto 
il minidisco di immissione, i dati vengono memorizzati in un file su disco. Prima di 
usare la procedura COPYDIAG deve essere eseguita la procedura INITDIAG per il 
minidisco su cui deve essere eseguita la copia. 


x 


Ì La procedura COPYDIAG esegue il programma di utilità $DCOPY. 
COPYDIAG 

| La procedura COPYDIAG non ha parametri. 

| Esempio 


| Per eseguire la procedura COPYDIAG: 


| COPYDIAG 
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PROCEDURA COPYI1 


La procedura COPYI1 copia i file da uno o più minidischi su uno o più altri mi- 
nidischi. COPYI1 può essere usata per creare una copia in più di un file su mini- 
disco oppure per riunire tutto lo spazio inutilizzato su minidisco in un'unica area 
libera su un altro minidisco. 


Se il sistema non ha il modulo a caricatore per minidischi, SSP legge i dati da co- 
piare dal minidisco nel modulo e quindi istruisce l'operatore di sistema a rimuo- 
vere il minidisco originale e a inserire il nuovo (destinato ad accogliere la copia) 
nel modulo. 


Se il Sistema ha un modulo a minidischi multiplo, la procedura COPYI1 può: 
e Copiareun file su minidisco da un alimentatore o da un singolo alimentatore 
del caricatore, su un altro minidisco inserito o nell'alimentatore o in un singolo 


alimentatore del caricatore. 


®  Copiarei dati contenuti nei minidischi di un caricatore su minidischi di un altro 
caricatore. 


® Fare copie multiple di un file su minidisco o di un intero minidisco su un caricatore. 


e Fare copie multiple di un file su minidisco o di un intero minidisco su un minidi- 
sco in un alimentatore singolo. 


e Fare copie multiple di un caricatore su un altro caricatore. 


L'operatore dovrà intervenire quando: 


® La stessa indicazione appare per il minidisco che deve essere copiato e quello 
che deve ricevere la copia. 


e Copie multiple di un file su minidisco o di un intero minidisco richiedono un solo 
alimentatore singolo. 


® Vengono eseguite copie multiple di caricatori. 
e Vengono eseguite più di 10 copie in un caricatore. 


Sul disco deve essere disponibile uno spazio di lavoro sufficientemente ampio per 
accogliere uno o più file su minidisco da copiare. 


Nota: Il minidisco di immissione deve essere nello stesso formato del minidisco 
che viene copiato e cioè un minidisco 1 o un minidisco 2D, e inizializzato nello 
stesso formato (FORMAT o FORMAT?2; parametri per la procedura INIT). 


Vengono normalmente copiati i minidischi con file importanti permanenti. Poiché 
i minidischi possono consumarsi con l’uso, è una buona idea avere più di una co- 
pia dei file su minidisco più importanti. 


FOX 


Se COPYI1 incontra un settore illeggibile sul minidisco che viene copiato, viene 
visualizzato il settore illeggibile. E” possibile correggere ie informazioni nel settore 
o copiarle come sono sul minidisco che riceve la copia. E’ possibile usare la se- 
guente funzione e i seguenti tasti di comando: 


Tasto Funzione 
Scorrimento in alto Esegue la scansione verso destra. 
Scorrimento in basso Esegue la scansione verso sinistra. 


Entr/Avanz.Rec Aggiorna il settore che viene visualizzato con le mo- 
difiche immesse dall'operatore. 


Tasto di comando 1 Visualizza il successivo settore. 
Tasto di comando 2 Visualizza il precedente settore. 
Tasto di comando 3 Se premuto mentre viene visualizzato un settore il- 


leggibile, fa sì che il settore venga copiato sul mini- 
disco di emissione. Se premuto mentre viene visua- 
lizzato un settore diverso da quello illeggibile, pro- 
voca la visualizzazione del settore illeggibile. 


‘La procedura COPYI1 esegue il programma di utilità $DUPRD. 


. 


corvi | ALL slumggsa],ià volume, [DELETE |, [PRESERvE], copie], 
nome file| |&gmmaa I 


immissione locazione alimentatore | , | emissione locazione alimentatore 
Sl 


ALL specifica che tutti i file su minidisco devono essere copiati su un altro 
minidisco oppure, se il settimo parametro è M1.01, M1, M2.01 o M2, che i 
contenuti dei minidischi nell’alimentatore di caricatore M1 devono essere co- 
piati sui minidischi nell’alimentatore di caricatore M2. Se il primo parametro non 
è specificato, si presume ALL. 


nome file specifica il nome del file (o libreria salvata) da copiare su un altro minidisco. 
Non è ammesso un nome se il settimo parametro è M1 o M1.01. 


mmggaa, ggmmaa o aammgg specifica la data di creazione del file da copiare. Se è 
specificato ALL come primo parametro, non è possibile specificare una data di crea- 
zione. La data specificata viene usata per verificare che sul minidisco da copiare 
si trovi il file corretto. La data specificata deve essere nello stesso formato della 
data della sessione; usare il comando di controllo STATUS SESSION per determi- 
nare il formato della data. Il file di emissione creato da COPYI1 ha la stessa data 
del file che viene copiato. 


id volume specifica l'ID di volume di uno o più minidischi destinati a ricevere la copia; 
possono essere specificati da 1 a 6 caratteri alfanumerici. 


CHECK 
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Nota: se viene specificato un caricatore, tutti i minidischi nel caricatore M2 de- 
vono avere lo stesso ID di volume dei minidischi nel caricatore M1. 


DELETE specifica che i file scaduti non sono da copiare. DELETE può essere specificato 
soltanto quanto è specificato ALL. 


PRESERVE specifica che deve essere copiato un intero file; cioè vengono conservati 
tutti i settori allocati al file (anche se alcuni settori non contengono dati). 


Se non viene specificato PRESERVE, vengono copiati i settori del minidisco che ‘ 


contegono dati. Cioè qualsiasi settore che non contiene dati non viene copiato e 
segue immediatamente la fine del file dopo l’ultimo settore copiato. 


copie specifica il numero delle copie di minidisco da eseguire e può essere qual- 
siasi numero da 1 a 99. Se non è specificato il valore delle copie, viene pre- 
sunto 1. 


locazione alimentatore immissione specifica l'alimentatore, il singolo alimentatore 
di un caricatore o un caricatore contenente il primo minidisco da copiare. Se 
non si specifica alcun parametro, viene assunto S1. Se deve essere copiato un 
solo minidisco, e l'ottavo parametro non è indicato, i dati vengono copiati sul 
minidisco dell’alimentatore 2 (S2). Se deve essere copiato un caricatore e l’ot- 
tavo parametro non è indicato, i dati vengono copiati sull'altro caricatore (M1 


su M2 o M2 su M1). Il sistema copia l’intero caricatore se è specificato 
M1,M1.01 o M2. 


locazione alimentatore emissione specifica l'alimentatore, il singolo alimentatore 
del caricatore o un caricatore contenente il primo dei minidischi su cui copiare. 
Se nel settimo parametro non viene specificato M1, M1.01 6 M2 viene assun- 
to S2. 


CHECK specifica che il sistema dovrebbe continuare a copiare minidischi da un 
magazzino se è incontrata una posizione vuota o si verifica un errore. In rispo- 
sta al messaggio di errore, l'operatore può far provare di nuovo la fettura o sal- 
tare all’altro minidisco nel caricatore. Il salto ad un altro minidisco in immissione, 
provoca lo stesso identico salto in emissione. 

Il parametro CHECK è valido soltanto quando si copia un caricatore. Se non si 
specifica CHECK, e un minidisco da errore o si trova un alimentatore vuoto, il 
sistema arresta la copia che stava eseguendo. 


Le combinazioni valide di questi parametri sono indicate nel prospetto che segue. 
Se la combinazione non risulta valida, è listato un codice errore e la sua spiegazione. 
VALORE ALIMENTATORE EMISSIONE 


ALIM. IMM, COPIE NOME FILE S1,S2. o $3 M2.01->M2.10 
ALL 1657 errore 


M1.01->M1.10/1 ALL Valido Valido 
M2.01->M2.10 

M1.01->M1.10] 1 Nome file Valido Valido 
M2.01->M2.10 

M1.01->M1.10| >1 ALL Valido 1657 errore 
M2.01->M2.10 

M1.01->M1.10| >1 Nome file Valido . 1657 errore 
M2.01->M2.10 


! Valido se il caricatore di immissione non è uguale a quello di emissione. 











1650 errore 
1650 errore 
Valido 
Valido” 
Valido! 
1645 errore 
Valido! 
1645 errore 
Valido! 
1645 errore 
Valido! 
1645 errore 



















1650 errore 






1650 errore 






Valido 





Valido 
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CODICI ERRORE 


Errore 1645 indica un tentativo di copiare un file ed il caricatore di immissione 
ed immissione coincidono. 


Errore 1650 indica un tentativo di fare una copia singola di un file su minidisco 
o un intero minidisco su un caricatore. 


Errore 1655 indica un tentativo di copiare un intero minidisco su un caricatore. 


Errore 1657 indica un tentativo di fare copie multiple di un minidisco su un 
singolo minidisco in un caricatore. 


Esempio 1 


Copia di un file su minidisco denominato PAYROLL su un minidisco con un ID 
di volume di VOLOO1. 


COPYI1l PAYROLL,,VOLOOl 


Esempio 2 


I file che occupano quattro minidischi, devono essere copiati su altri quattro 
minidischi, ciascuno dei quali ha come ID di volume VOL002. | quattro mini- 
dischi da copiare sono nelle prime quattro locazioni del caricatore nell’alimenta- 
tore M1 e i minidischi che riceveranno la copia sono nelle prime quattro locazio- 
ni del caricatore nell’alimentatore M2, 


COPYl ALL,,VOL002,,,,Ml 


Esempio 3 


Fare due copie, di tutti i file su minidischi nel caricatore 2 su minidischi nel caricato- 
re 1, con minidischi aventi tutti lo stesso ID di volume VOL0003. | file con data 
scaduta non devono essere copiati; anche i settori senza dati devono essere copia- 
ti. Se si verifica un errore su minidisco, o se un alimentatore di caricatore risulta 
vuoto, viene segnalato un messaggio per poter tentare di nuovo la lettura o per po- 
ter saltare l'alimentatore vuoto. 


COPYl ALL,VOLO03,DELETE, PRESERVE,2,M2,M1, CHECK 


PROCEDURA COPYPRT 


COPYPRINT 


La procedura COPYPRT crea un nuovo file su disco e copia una o più entrate di file 
di stampa differita dal file di stampa differita. È possibile copiare in una sola volta 
un massimo di 255 entrate. Le entrate selezionate del file di stampa differita pos- 
sono anche essere visualizzate e stampate. 


La procedura COPYPRT non può copiare entrate di file di stampa differita create 
dal DW/36 o tutti i record del file di stampa differita creati in modo trasparente co- 


me ad esempio quelli saltati durante una copia. 


La procedura COPYPRT esegue i programmi di utilità $SUASF e $UASC. 


ALL [nome fe | , {RELEASE |, {CRT 
id stampa differita CANCEL PRINT 
Fxxxx 


SYSTEM 
NOCOPY 


ALL specifica che devono essere copiate tutte le entrate del file di stampa diffe- 
rita. Se il primo parametro non è specificato, si presume ALL. Vengono co- 
piate soltanto le entrate che non vengono già elaborate dal programma di 
stampa differita e quelle entrate che hanno lo stesso ID utente dell'operatore 
che ha emesso la procedura. 


id stampa differita specifica l'ID di file per stampa differita a sei caratteri dell’en- 
trata del file di stampa differita da copiare. Le entrate che vengono già ela- 
borate dal programma di stampa differita non sono copiate, 


Se non è attiva la riservatezza con parola d’ordine, gli operatori possono copia- 
re tutti gli ID di stampa differita. Se è attiva la riservatezza con parola d'ordine, 
l'operatore deve avere una classificazione di riservatezza di operatore di siste- 
ma o più elevata per poter copiare qualsiasi ID di stampa differita che appartie- 
ne ad un altro operatore; altrimenti può soltanto copiare le entrate che gli 
appartengono. 


Fxxxx specifica il numero di modulo di una o più entrate di file di stampa diffe- 
rita da copiare. xxxx è il numero di modulo a quattro caratteri delle entrate 
da copiare. Le entrate che vengono già elaborate dal programma di stampa 
differita non sono copiate. 


Se non è attiva la riservatezza mediante parola d'ordine, gli operatori possono 
copiare tutti gli ID di stampa differita o ID con specifici numeri di modulo. Se 
è attiva la riservatezza con parola d'ordine, l'operatore deve avere una classifi- 
cazione di riservatezza di operatore di sistema o più elevata per poter copiare 
qualsiasi entrata di file di stampa differita che appartiene ad un altro operatore; 
altrimenti può copiare soltanto le entrate che gli appartengono. 


Per ulteriori informazioni sui numeri di modulo, vedere la Procedura PRINT, 
la Specifica OCL FORMS o la Specifica OCL PRINTER. 


SYSTEM specifica che devono essere copiate tutte le entrate del file di stampa 
differita che non vengono già elaborate dal programma di stampa differita, 


Se non è attiva la riservatezza con parola d'ordine, possono essere copiate 
tutte le entrate. Se è attiva la riservatezza con parola d'ordine, l'operatore 
deve avere ùna classificazione di riservatezza di operatore di sistema o più 
elevata per poter copiare tutte le entrate. 
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NOCOPY specifica che deve essere visualizzato un file su disco che contiene una 
o più entrate di file di stampa differita, precedentemente copiato usando CO- 
PYPRT. È possibile inoltre visualizzare o stampare informazioni di file storico 
che erano state copiate usando la procedura HISTORY COPYPRT; vedere la 
Procedura HISTORY per ulteriori informazioni. Se viene specificato NOCOPY, 
RELEASE o CANCEL sono illeciti. 


nome file specifica il file su disco che deve essere creato per contenere le entrate 
del file di stampa differita copiate (o il file che deve essere visualizzato o stam- 
pato se viene specificato NOCOPY. Deve essere specificato un nome file se 
come primo parametro viene indicato ALL, SYSTEM o NOCOPY o se il primo 
parametro non è specificato. 


Se non è specificato un nome file ma viene indicato un ID di file di stampa 
differita o un numero di modulo, il nome file assunto è rispettivamente 1'ID 
del file di stampa differita o Fxxxx più VID a 2 caratteri dell'unità video. 
Per esempio, se l'operatore all'unità video W3 immettesse la procedura 
COPYPRT specificando un ID di file di stampa differita di SP0032, il nome 
file sarebbe SP0032W3; se dallo stesso operatore sulla stessa unità video fosse 
immesso un numero di modulo di 0001, il nome file sarebbe F0001W3. 


Il formato del file è descritto in Formato del file per i file COPYPRT, 


RELEASE specifica che quando la procedura COPYPRT ha copiato le entrate del 
file di stampa differita su un file su disco, le esntrate del file di stampa diffe- 
rita specificate nel parametro devono essere rilasciate per la stampa. 


CANCEL specifica che quando la procedura COPYPRT ha copiato ie entrate del 
file di stampa differita su un file su disco, le entrate del file di stampa diffe- 
rita specificate dal parametro 1 devono essere rimosse dal file di stampa dif- 
ferita. 


CRT specifica che le entrate dei file di stampa differita devono essere visualizza 
te. E’ inoltre possibile usare questa opzione per stampare le entrate che sono 
state copiate. La Fig. 6 mostra come vengono visualizzate le entrate e spiega 
i campi sullo schermo. Se il primo parametro è NOCOPY ed il quarto è omesso, 
viene assunto CRT. 


PRINT specifica che le entrate del file di stampa differita devono essere stampate. 
PRINT è consentito se è specificato anche NOCOPY. 


Se questo parametro è specificato, viene stampato ogni elemento copiato del 
file di stampa differita nel file di immissione. Tutti i valori per FORMSNO, CO- 
PIES, ALIGN, LINES, LPI, FONT e JUSTIFY con i quali erano stati creati o8 ele- 
menti originali del file di stampa differita, vengono conservati. 


Se l'esecuzione avviene da una stazione video, la stampatrice usata sarà quel- 
la di sessione o quella di sistema. 


Se questo parametro è specificato, non vi è aluna richiesta per la stazione di 
lavoro. Il file è stampato e COPYDATA termina. 
Richieste di stampa possono essere richiamate o poste nella coda dei lavori. 


Esempio 1 


3 Copia dell'entrata di file di stampa differita SP0001 in un file denominato 
7 SP0001W2. La procedura COPYPRT viene immessa dall'unità video W2, 


COPYPRT SPOOO1l 


Esempio 2 


Copia di tutte le entrate del file di stampa differita in un file denominato 
SPFILE. 


COPYPRT SYSTEM,SPFILE 


Esempio 3 
Copia di tutte le entrate del file di stampa differita con numero di modulo 0017 
in un file denominato 0017W3. La. procedura COPYPRT è immessa dall'unità 
video W3. 


COPYPRT FOO17 
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Esempio 4 


Per copiare tutte le entrate del file di stampa differita in un file denominato 
TEMP, cancellare le entrate dal file di stampa differita e visualizzare le entrate. 


COPYPRT ,TEMP,CANCEL,CRT 


Formato del file per i file COPYPRT 


Per ciascuna entrata nel file di stampa differita copiata sul file su disco, viene 
creato un record di testata di 150 byte. (Se la iunghezza della riga di stampa è 
maggiore di 132, la lunghezza di record è 215). Il record di testata contiene i 
seguenti campi: 










Colonna 
d'inizio 










Lunghezza 
campo 







Contenuti della descrizione 






La lettera H (per indicare la testata) 
L'ID del file di stampa differita dell'entrata 
Il nome della procedura 
II nome del lavoro 





























L'ID utente dell'operatore 


Il nome dei file di stampa 
L'ID della stampatrice 


li numero del modulo 














I! numero delle copie (in binario) 





Il numero delle pagine (in binario) 
Il numero dei record (in binario) 


















Il numero delle righe per pagina (in binario) 


La lettera M se questa entrata contiene 
record di stampa con una lunghezza 
maggiore di 132 ; 


Ei 



















Valori diggiustamento 
Allineamento (Y o N) 


Tutte le posizioni inutilizzate sono impostate a spazi vuoti. 






Dopo il record di testata, ci sono i record dei caratteri dei dati. Questi record 
hanno una lunghezza di 150 caratteri. (Se la lunghezza della riga di stampa è 
maggiore di 132, la lunghezza dei record è di 215). I record dei caratteri dei dati, 
contengono i campi seguenti: 


Colonna Lunghezza 
d'inizio Contenuti della descrizione 


Il numero di pagina (in binario) 





II numero di riga (in binario) 
Il numero di record (in binario) 
| dati da stampare 
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E’ possibile premere il tasto Help per ottenere informazioni sullo schermo se- 
guente. 


** COMPLETO** 
NOME LAV, UTENTE STAMPAT. + PAG. RECORD 


SP0000 W1110134 MAT535 PRINTKEY 
SPO001 W1110428 MAT535 BASIC255 
SP0003 W1110701 MAT535 PRINTKEY 
sPOOO, W1110759 MAT535 —PRINTKEY 
SP0005 W1110843 MAT535 PRINTKEY 
SP0006 W1110916 MAT535 PRINTKEY 
SPO007 W1110922 MAT535 PRINTKEY 
sP0008 W1110930 MAT535 PRINTKEY 
SP0009 W1110948 MAT535 PRINTKEY 
SPOO10 W1111055 MAT535 PRINTKEY 
SPOOl1 WI111110 MAT535 PRINTKEY 
SPOO12 W1111429 MAT535 PRINTKEY 
SP0013 W1111627 MAT535 PRINTKEY 
SPOOlh W1111702 MAT535 PRINTKEY 


30 
30 
30 
30 
30 
30 
30 
30 
30 
30 
30 
30 
30 
30 


PPPPPEFEEPEEEHWHE 


INTESTAZIONE SCELTA- STAMPA (Y/N)- N COPIE- ol 
DA PAGINA A PAGINA n ENTR/RICH AIUTO CMD7-Fine 


Figura 6. Schermo campione COPYPRT che mostra la testata delle entrate 


del file di stampa differita 


Descrizione dei campi 


NUM. specifica il numero dell'entrata, E’ possibile immettere questo numero nel 
campo INTESTAZIONE SCELTA per visualizzare (o stampare) l’entrata. 


1/D specifica l'ID del file di stampa differita dell'entrata. 
PROC specifica il nome della procedura che ha creato un'entrata. 


NOME LAV. specifica il nome assegnato dal sistema del lavoro che ha creato 
l'entrata. 


UTENTE specifica l'ID dell'utente dell'operatore che ha creato l’entrata, 
STAMPAT. specifica il nome del file di stampa assegnato all'entrata. 
ID specifica I'D della stampatrice. 
MOD. specifica il numero di modulo associato all'entrata. 
PAG, specifica il numero di pagine per l’entrata, 
RECORD specifica il numero di record di stampa associati all'entrata. 
Questo numero non comprende tutti i record di stampa in modo trasparente 


che possono essere stati nell'entrata copiate del file di stampa differita. 


M specifica che l’entrata di stampa contiene record con una lunghezza maggiore 
di 132, 


INTESTAZIONE SCELTA specifica il numero di testata che si vuole visualizzare 
o stampare, 


STAMPA Y/N specifica se l’entrata deve essere stampata. Immettere N per 
visualizzare l’entrata, Immettere Y per stamparla. Se si specifica Y, la stampa 
avverrà sulla stampatrice di sessione. | parametri dei numeri dei moduli, delle 
linee per pagina, delle linee per pollice, e dei caratteri per pollice, verranno as- 
sunti come quelli di sessione. N viene assunto. 


COPIE specifica il numero di copie da stampare, E' possibile immettere un 
numero da 1 a 99, 


DA PAGINA specifica la pagina d’inizio da visualizzare o stampare. Se non viene 
specificata alcuna entrata, la stampa inizia dalla prima pagina, 


A PAGINA specifica la pagina finale da visualizzare o stampare. Se non viene 
specificata alcuna pagina, la stampa termina con l’ultima pagina. 


Per esempio selezionando la testata 1, si provoca la visualizzazione di quell’entrata. 


MSA TA SI 


+ ù + 5 + 6 
+ 0 + 0 + 0 
3 e Pe e e e e RD RR e ll RR e e he RR h R R l d e  dl l dl a leak ale fe ded 
16 120 2 1 096 #LIRRARY 
0001.00 
0002, 00 SCRNPRT PROGRAMMA 
0003. 00 
c00Ì. 00 Questo programma stampa le informazioni contenut 
0005, 00 
0006. 00 
0007.00 Nome del file che contiene le informazioni 
0008.00 
0009, 00 Id stampatrice da usare 
0010.00 
0011. 00 Numero di copie . . . + 


02 
03 
où 
05 
06 
OT 
08 
09 
10 
dl 
12 


OOO O dk Od 


NUM, PAGINA NUM. LINEA POS. AVVIO SCHERMO 
NUM. RECORD ENTR/Scorr.av./Scorr.in./RICE AIUTO 
CMDI-Rivisualizzazione intestazioni CMD2-Modo variazione CMD7-Fine 





Figura 7. Schermo campione COPYPRT che mostra una pagina da uno 
schermo copiato 


Descrizione dei campi: 


NUM. PAGINA specifica la pagina da visualizzare. Immettere un numero in que- 
sto campo per visualizzare una pagina specifica. 


NUM. LINEA specifica la riga di stampa da presentare nella parte superiore dello 
schermo, Immettere il numero di una riga di stampa che fa sì che quella riga 
venga presentata nella parte superiore della pagina. i 


POS. AVVIO SCHERMO specifica la posizione iniziale più a sinistra delle colon- 
ne da visualizzare. Immettere un numero in questo campo per spostare le co- 
lonne visualizzare a destra o a sinistra. 


NUM. RECORD specifica il record di stampa da presentare nella parte superiore 


dello schermo, Immettere il numero di un record per far sì che quel record 
venga presentato nelia parte superiore dello schermo. 
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PROCEDURA CREATE 


La procedura CREATE genera un membro oggetto di messaggi da un membro 
origine di messaggi. Un membro di messaggi contiene messaggi che possono essere 
visualizzati o stampati da un programma o su tracciati video o dalla Procedura 
ERR. E' possibile inoltre usare la Specifica //* (Messaggio informativo) e \a Spe- 
cifica //** (Messaggio di console di sistema} per visualizzare i messaggi. Può an- 
che essere usata l'Espressione ?Mmic? o ?M'mic,posizione, lunghezza‘? (Membro 
di messaggi) per ottenere un messaggio da un membro oggetto di messaggi. 


L'immissione per la procedura CREATE è un membro origine di messaggi. ll 
membro origine di messaggi contiene tre tipi di specifiche: 


é La specifica di controllo di messaggi 
e Unoo più specifiche di testo di messaggi 
e Unao più specifiche di commento (facoltative). 


Queste specifiche sono descritte in Specifiche dei Membri Messaggi. 


Il membro origine può essere creato usando il programma di utilità Immissione 
dati origine (SEU); per le informazioni sull'uso di SEU, vedere il manuale Guida 
SEU. E' inoltre possibile usare il programma di utilità $MAINT; vedere Program- 
ma di utilità $SMAINT, funzioni addizionali per ulteriori informazioni. 


La procedura CREATE esegue il programma di utilità $MGBLD. 


CREATE nome membro origine ,|REPLACE] ,| nome libreria s |HALT 
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libreria corrente NOHALT 





nome membro origine specifica il membro origine di messaggi esistente che con- 
tiene le specifiche origine di messaggio. Ò 


REPLACE specifica che il membro oggetto di messaggi creato deve sostituire un 
esistente membro oggetto con lo stesso nome. Il nome del membro oggetto 
è indicato dalla specifica di controllo messaggio nel membro origine. 


Se non viene specificato REPLACE, il membro oggetto con lo stesso nome 
non deve essere sostituito. Se esiste un membro oggetto con lo stesso nome, 
viene visualizzato un messaggio e l'operatore può sostituire il membro ogget- 
to o cancellare il lavoro. 


nome libreria specifica la libreria che contiene il membro oggetto e in cui il mem- 


bro oggetto deve essere inserito. Se non è specificato il nome della libreria, 
viene assunta la libreria corrente. 


HALT specifica che se s'incontrano errori in un membro origine di messaggi, deve 
essere visualizzato un messaggio. Se non viene specificato alcun parametro, si 
presume HALT. A 


NOHALT specifica che non deve essere visualizzato nessun messaggio se si incon- 
trano errori nel membro origine di messaggi. 


Esempio 


Per generare un membro oggetto di messaggi da un membro origine denominato 
MESSAGES contenuto nella libreria MYLIB, occorrerebbe immettere la proce- 


dura CREATE come segue: 


CREATE MESSAGES, ,MYLIB 
Specifiche di un membro di messaggi 


La specifica di controllo messaggi 


La specifica di controllo messaggio indica il nome del membro oggetto di messag- 
gi da crearsi dalla procedura CREATE e se il membro di messaggi deve essere di 
primo o di secondo livello. La specifica di controllo di messaggi deve essere la 
prima riga del membro origine e ne è ammessa soltanto una. 


Il formato della specifica di controllo di messaggi è: 


nome membro oggetto ,|1 


2 


nome membro oggetto specifica il membro oggetto di messaggi da creare. Un no- 
me membro può contenere fino a 8 caratteri e deve iniziare con un carattere 
alfabetico (da A a Z, #, $ o @). | rimanenti caratteri possono essere qualsia- 
sì combinazione di caratteri (numerici, alfanumerici e speciali). Occorre evi- 
tare i seguenti caratteri in quanto hanno significati speciali nelle procedure: 
virgole (,), apici (‘), spazi in bianco, punti di domanda (?), barrette (/), segni 
di maggiore di (>), segni più (+) e segni di uguale (=). Non usare DIR, LIBRA- 
RY o ALL come nome di membro. 


1 Specifica che il membro è un membro di messaggi di primo livello. | membri 
di messaggi di primo livello possono avere fino a 75 caratteri di testo di mes- 
saggio. Se non è specificato il parametro di livello di messaggio, viene assunto 
1. 


2 Specifica che il membro è un membro di messaggi di secondo livello. 1! mem- 
bri di messaggi di secondo livello possono avere un massimo di 225 caratteri 
nel testo del messaggio. 


Questo esempio mostra il formato di una specifica di controllo messaggi. Il nome 
da assegnare al membro oggetto è MESSAGES. ll membro oggetto deve essere un 
membro di messaggi di primo livello, 


MESSAGES, 1 
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Specifica di testo messaggi 


La specifica di testo messaggi indica un codice di identificazione messaggio (MIC) 
e il testo del messaggio. 


II formato della specifica di testo messaggi è: 


messaggio 





mic specifica il codice di identificazione messaggio {MIC). MIC deve essere un nu- 
mero a quattro cifre da 0000 a 9999 e deve essere inserito nelle posizioni da 
1 a 4 della specifica di testo messaggi. I! MIC in un membro di messaggi de- 
vono essere in ordine ascendente. Lo stesso MIC può essere specificato più di 
una volta per le specifiche che hanno una grande quantità di testo. Il numero 
delle specifiche che possono specificare lo stesso MIC è limitato al numero 
delle specifiche richieste per indicare fino a 75 caratteri per i messaggi di pri- 
mo livello e fino a 225 caratteri per i messaggi di secondo livello. 


messaggio specifica il testo del messaggio. L'area di testo inizia alla posizione 6 
nella specifica di testo e continua fino alla fine della riga del membro di mes- 
saggio. Il testo del messaggio è costituito dai caratteri che iniziano dalla posi- 
zione 6 fino all'ultimo carattere diverso dallo spazio in bianco della riga. 


Questo messaggio mostra il formato di una specifica di testo messaggi. Il numero 
mic è 0014; il testo del messaggio segue il numero. - 


001% This is a message 


Se il messaggio continua su un'altra riga origine, l'area di testo sulla riga seguente 
è aggiunta alla fine della riga precedente, compresi uno o più spazi in bianco dal- 


la riga precedente. Per esempio: 


Indicatori di colonna 
1 2 3 ù 
1234567890123456789012345678901234567890 


MESSAGE, 2 
0001 This is the first message and it 
0001 is continued on this line. 


Le specifiche vengono lette fino alla loro lunghezza, che è impostata quando vie- 
ne creato il membro (da SEU o $MAINT). In un membro origine con una lun- 
ghezza di specifica di 40, le righe precedenti produrrebbero un membro oggetto 
di messaggi di secondo livello denominato MESSAGE. Message 0001 conterrebbe 
il seguente messaggio (notare gli spazi nel messaggio combinato provocati dagli 
spazi che seguono quella prima riga del testo di messaggio: 


This is the first message and it is continued on this line, 


228 


Specifica di commento 


Questa specifica di commento è facoltativa. Il suo formato è il seguente: 
* commento 


Nella prima posizione della specifica deve esserci un asterisco (*). Questa specifi- 
ca non diventa parte del membro oggetto di messaggi. La specifica di commento 
non può essere la prima specifica nel membro origine di messaggi. 


Esempio di membro origine di messaggi 


Si supponga che un membro origine di messaggi contenga le seguenti specifiche; 
Notare come sono raggruppati i messaggi per i due programmi. 


MESSAGES,1 

* The following messages are for the program PAYROLL (00xx) 
0001 Enter yesterday's date: 

0002 Enter today's date: 

0003 Enter tomorrow's date: 

* The following messages are for the program ACCTS (01xx) 
0101 Accounts Payable program is running. 

0102 Make sure printer P3 is powered on. 

0103 Accounts Payable program is complete. 
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PROCEDURA DATE 
La procedura DATE cambia la data di sessione o la data del programma. 


Se si immette la procedura DATE e questa non è tra una specifica OCL LOAD 
e una specifica OCL RUN, la data di sessione viene cambiata. Una sessione ini- 
zia quando l'operatore si collega e termina quando l'operatore immette il co- 
mando OFF. Se la procedura DATE non è usata per stabilire una data di ses- 
sione, viene usata come data di sessione la data del sistema specificata durante 
il caricamento del programma iniziale (IPL). 


Se si immette la procedura DATE tra una specifica OCL LOAD e una specifica 
OCL RUN in una procedura, essa indica la data del programma; è cioè la data 
che il programma usa. La data del programma è anche detta data del passo dì 
lavoro. Quando il programma termina, la data di sessione viene usata come da- 
ta del programma. Se non è immessa la procedura DATE tra una specifica 
LOAD e una specifica RUN, la data di sessione viene usata come data di pro- 
gramma. Se si immettono due o più procedure DATE tra una specifica LOAD 
e una specifica RUN, viene usata l’ultima procedura DATE. 


La procedura DATE elabora una specifica OCL DATE. 
Note: 


1. La data del programma è usata per determinare il periodo di ritenzione dei 
file per i file su minidisco usati dai programma e può essere portata sull’e- 
missione stampata. La data del programma è anche usata come data di crea- 
zione di qualsiasi file su disco o minidisco creati dal programma. 

2. Se un lavoro è inserito nella coda di lavori di immissione, gli viene assegnata 
la data del programma quando il lavoro é stato inserito nella coda dei lavori. 

3. Allo scadere delle 24.00 (mezzanotte), la data del sistema viene automatica- 
mente aggiornata, ma la data di sessione e fa data del programma no. 





La data specificata sulla procedura DATE deve essere nel formato della data cor- 
rente della sessione. La data della sessione può essere in uno qualsiasi di tre for- 
mati: mese-giorno-anno (mmggaa), giorno-mese-anno (gammaa) o anno-mese-gior- 
no {aammgg). E’ possibile usare il comando STATUS SESSION per mostrare il 
formato della data della sessione corrente e la procedura SET per cambiare il for- 
mato della data della sessione corrente. 


mm, gg e aa devono essere ciascuno un numero a due cifre, ma gli zeri di testa 
nel mese e nel giorno, possono essere omessi quando viene usata la punteggiatura. 


230 


Non è ammessa una data di tutti zeri (000000). La data può essere immessa con 
o senza segni di punteggiatura. Per esempio 24 Luglio 1984 potrebbe essere spe- 
cificato in uno dei seguenti modi: 


T-24-8k  mm-ge-aa 
oh-7-8L gg-mm-aa, 
84-7-2h aa-mm-gg 


072484 —mmgga@ 
210784 gemma a 
8U072h aangg 


Nella forma con punteggiatura, può essere usato come segno di punteggiatura 
qualsiasi carattere salvo le virgole (,), gli apici (‘), i numeri e gli spazi in bianco. 
In ogni caso se la procedura DATE è all’interno di un’altra procedura, i punti di 
domanda (?), le barrette (/), i segni di uguale (=) e i trattini di divisione sillabica 
(-), devono essere usati con cautela in quanto questi caratteri hanno significati 
speciali nell'ambito delle procedure. 


Esempio 1 


Per specificare una data di sessione per il 1° Luglio 1984, l'operatore dovrebbe 
immettere dalla tastiera: . 


DATE 7-1-8h 
oppure 


DATE 07018 


Esempio 2 


Per specificare una data di lavoro per i programmi PAYROLL e PAYPRNT, oc- 
corre inserire la procedura DATE davanti alla prima specifica OCL LOAD nella 
procedura. 


// * ‘ENTER PAYROLL DATE! 

DATE ?1R? 

// LOAD PAYROLL 

// FILE NAME-EMPLOYES 

// FILE NAME-CHECKS,RETAIN-J,BLOCKS-100 

// RUN 

// LOAD PAYPRNT 

// FILE NAME-CHECKS,RETAIN-J 

// PRINTER NAME-PRINT,SPOOL-NO,LINES-25,FORMSNO-CHCK, 
ALIGN-YES,DEVICE-P3 

// RUN 
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PROCEDURA DEFINEID 


La procedura DEFINEID è usata per specificare una lista di ID a distanza per 
una linea di comunicazione commutata quando si usa il sottosistema SSP-ICF 
BSCEL. Quando il Sistema/36 che usa BSCEL è collegato ad un sistema a distan- 
za mediante una linea di comunicazione commutata, la lista viene esaminata per 
un confronto con l'ID ricevuto dal sistema a distanza. Questa lista viene esami- 
nata soltanto quando sono state specificati più ID di linee commutate multiple 
a distanza nel momento della configurazione del sottosistema. Se si trova l'ID, 
l'inizializzazione della linea si conclude con successo. Se non è trovato, il sistema 
a distanza viene scollegato. 


La procedura DEFINEID esegue il programma di utilità $IDSET. La procedura 
DEFINEID crea un file di sistema denominato #IBSRID, lungo 4 settori e che 
può contenere fino a 55 ID a distanza. 


La procedura è descritta nel manuale Using System/36 Communications. 


DEFINEID DISPLAY 
UPDATE 


DELETE 


DISPLAY specifica che devono essere visualizzati gli ID a distanza. Gli ID a di- 


x 


stanza non possono essere modificati. Questo parametro è valido soltanto se 
sono definiti gli ID a distanza. 


UPDATE specifica che la lista degli ID a distanza deve essere creata o che la lista 
esistente di ID a distanza deve essere modificata. 


DELETE specifica che l’intera lista di ID a distanza (file #IBSRID) deve essere 
cancellata dal disco. Questo parametro è valido soltanto se sono definiti ID 
a distanza. 
Esempio 


Per creare o aggiornare la lista degli 1D a distanza: 


DEFINEID UPDATE 














Pagina lasciata intenzionalmente-bianca > 





298” 























234 


Pagina lasciata intenzionalmente bianca 








Se 








PROCEDURA DEFINEPN 
La procedura DEFINEPN definisce un modo per creare o aggiornare un elenco 
telefonico per il dispositivo di chiamata automatica. Ciascun elenco telefonico 
può contenere un massimo di 105 numeri. Gli elenchi telefonici sono creati dalla 
procedura DEFINEPN e sono usati dal dispositivo di chiamata automatica. 
La procedura è descritta nel manuale Using System/36 Communications. 


La procedura DEFINEPN esegue il programma di utilità $PNLM. 


DEFINEPN 


La procedura DEFINEPN non ha parametri. 
| Esempio 
| Per eseguire la procedura DEFINEPN: 


| DEFINEPN 


| PROCEDURA DEFINLOC 


La procedura DEFINLOC consente di attivare una lista i nomi e di ID di ubicazioni 
remote a cui è consentito di chiamare il sottosistema. 


| Per maggiori informazioni vedere il manuale Using System/36 Communications. 


DEFINLOC 


Ì La procedura DEFINLOC non ha parametri. 
| Esempio 


Questo esempio mostra come attivare una lista di nomi a cui è consentito di chia- 
mare il sottosistema. 


| DEFINLOC 
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PROCEDURA DEFINX21 
La procedura DEFINX21 fornisce un modo per creare o aggiornare un elenco di nu- 
meri di collegamento su reti pubbliche per il dispositivo X.21 o una configurazione 


linea in modo scollegamento se non attiva. 


Può inoltre creare, sempre che già non esiste, la libreria # X21LIB per il modo scol- 
legamento se non attiva. 


| La procedura DEFINX21 è descritta nel manuale Using System/36 Communications. 


| La procedura DEFINX21 esegue i programmi di utilità $ XNLM e $ XNSH. 


DEFINX21 NONSHM 


SHM 





NONSHM specifica che si vuole creare o aggiungere un elenco di numeri di collega- 
mento X.21 non in modo scollegamento se la linea non è attiva. Ciascun elen- 
co può contenere un massimo di 75 numeri. 

Gli elenchi creati dalla procedura DEFINX21, vengono memorizzati come membri 
oggetto di libreria. 

SHM specifica che si vuole creare, aggiornare, stampare o cancellare una configu- 
razione linea in modo scollegamento se non attiva. Ciascuna configurazione 
linea è una informazione di linea locale. Questa informazione è memorizzata 
come un membro oggetto nella libreria #X21LIB. 

Con SHM si riduce l'utilizzo della linea, poiché il collegamento viene interrotto 
quando non vi è attività su di essa. 


| Esempio 1 


Î Per creare o aggiornare un elenco di numeri di collegamento non in modo scollega- 
mento se la linea non è attiva. 


| DEFINX21 NONSHM 


| Esempio 2 
I Per aggiornare una configurazione linea in modo scollegamento se non attiva. 


| DEFINX21 SHM 


235.1 


Ta 


DEFINX25 


PROCEDURA DEFINX25 


La procedura DEFINX25 consente di creare o editare una lista di indirizzi di rete re- 
moti usati per il dispositivo X.25. La procedura DEFINX2 5 consente anche di crea- 
re o editare un elenco di numeri telefonici nel caso si utilizzi un sottosistema asin- 
crono. La procedura DEFINX25 è descritta nel manuale Using System/36 
Communications. 


La procedura DEFINX25 non ha parametri. 


Esempio 
Per eseguire la procedura DEFINX25: 


DEFINX25 


235.2 
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DELETE { 


DELETE 


PROCEDURA DELETE 


ALL 


La procedura DELETE rimuove uno o più file, librerie o cartelle da un minidisco o 
da un disco. Può inoltre essere usata per cancellare file di un sistema remoto se 
non definiti nel NRD (indirizzario risorsa di rete). 


La procedura DELETE non può essere usata per cancellare un file, una libreria o car- 
tella, mentre questo viene usato da un altro lavoro oppure se viene indicata una 
specifica di file nell'ambito del passo di lavoro quando il nome file e l’identificazione 
del file per quella specifica non corrispondono. Non può neppure essere usata per 
cancellare un file a indice che sul disco dispone di uno o più file con indici alternati- 
vi. La libreria di sistema (# LIBRARY), i file di sistema (per esempio il file cronologi- 
co, #SYSHIST), i file di lavoro edi file provvisori non possono essere cancellati 
con questa procedura. 


Per rimuovere uno o più membri da una libreria, vedere la Procedura REMOVE, 
La procedura DELETE esegue il programma di utilità $DELET. Per informazioni 
sul modo con cui cancellare dal disco tutti i file e le librerie, fare riferimento al 


programma di utilità $DELET. 


Per cancellare uno o tutti i file dal minidisco: 


nome a [n] s SCRATCH], [mmggaa |,,|locazione iniziale 


REMOVE genmaa S1 
ERASE aammeg S2 
53 
Ml.nn 
M2.nn 


locazione finale 4 [ia volune | 
locazione iniziale 


Sl 
S2 
53 


Ml.nn 
M2.nn 





Per cancellare un file, una libreria, una cartella o un gruppo di file, librerie o cartelle 
dal disco: 


nome file sFl1,| SCRATCH |,| mmggaa |{,|LIBR ... [none ‘aruppo | 
nome libreria REMOVE egmmaa FOLDER 


nome cartella ERASE aammgg ALL 
ALL 
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nome file, nome libreria o nome cartella specifica il file da cancellare dal minidisco 


O il file, la libreria o la cartella da cancellare dal disco. 


Per i sistemi con un modulo a minidischi a caricatore: se un file è contenuto 
in più di un minidisco e non è specificata alcuna locazione finale, l’elabora- 
zione continua fino a che il file non è canceliato dall'ultimo minidisco; co- 
munque, l'elaborazione non può passare da un alimentatore singolo ad uno 


multiplo o viceversa. 


Se è specificato un alimentatore (51, S2 o S3) come locazione di partenza, 
l'elaborazione rimane nell’ambito degli alimentatori. L'elaborazione inizia 
alla locazione specificata e continua fino a S3. Quindi, se il file è contenuto 
su minidischi addizionali, questi saranno elaborati iniziando dalla locazione 
specificata e continua fino a S3, 


Se viene specificata una posizione in un caricatore (M1.nn o M2.nn), come 
locazione di inizio e non viene specificata nessuna locazione finale, l'elabora- 
zione rimane nell’ambito del caricatore specificato (M1 o M2). L’'elaborazio- 
ne inizierà alla locazione specificata e continuerà fino a M1.10 o M2.10. 
Quindi, se il file è contenuto su minidischi addizionali, questi verranno ela- 
borati iniziando dalla locazione specificata e continuando fino a M1.10 o 


M2.10. . 


Per esempio, il file FILEA è contenuto su tre minidischi e S2 è specificato 
come locazione di inizio ma non è specificata alcuna locazione finale. 11 
file è cancellato dai minidischi in S2 e S3. Viene quindi visualizzato un mes- 
saggio che chiede l’inserimento del successivo minidisco in S2. Ii file viene 
quindi cancellato da S2 e l'elaborazione si interrompe. 


ALL specifica quanto segue: 


e Se viene indicato !1, saranno cancellati tutti i file sul minidisco. 


e Se viene indicato F1, deve essere specificato un nome di gruppo. Saran- 
no cancellati tutti i membri del gruppo di file. 


e Se vengono indicati sia F1 che LIBR ed è specificato anche un nome di 
gruppo nella nona posizione di parametro, saranno cancellati tutti i file 
e le librerie che sono membri del gruppo di file, 


e Se vengono indicati F1 e FOLDER, e un nome di gruppo è anche specificato 
nel nono parametro, vengono cancellati tutti i file e cartelle che sono membri di 


un gruppo di file. 


e Se vengonoindicati F1 e ALL, e un nome di gruppo è anche specificato nel no- 
no parametro, vengono cancellati tutti i file, librerie e cartelle che sono membri 


di un gruppo di file. 


Specifica che il file deve essere cancellato dal minidisco. Se non è specificato 
Un secondo parametro, viene presunto 11. Se il file è contenuto in più di un 
minidisco, può essere visualizzato un messaggio e l'operatore può inserire il 
successivo minidisco. 


F1 Specifica che il file o la libreria, devono essere cancellati dal disco. 


SCRATCH specifica quanto segue: 


e Se il file è su minidisco, la data di scadenza deve essere impostata alla 
data del passo di lavoro corrente. li file rimane sul minidisco e ad esso 
si può accedere soltanto per la lettura, Se si scrive qualsiasi nuova in- 
formazione sul minidisco, il file non esiste più. 


e Seilfile, la libreria o la cartella è su disco, l'entrata VTOC per Il file deve 
essere rimossa. Ciò lascia spazio nella VTOC e sul disco da usare per altri 
dati. Per il disco, SCRATCH e REMOVE, fanno la stessa cosa. 


Se non è specificato un terzo parametro, si presume SCRATCH. 


NOTA: Sebbene il file non sia più su disco o minidisco la data non è stata cancella- 
ta e può essere letta utilizzando la procedura PATCH. 


REMOVE specifica per il minidisco o il disco, che l’entrata VTOC per il file, la 
libreria o la cartella deve essere rimossa. Ciò lascia spazio nella VTOC e sul di- 
sco per altri dati. Per il disco, SCRATCH e REMOVE eseguono la stessa funzione. 


NOTA: sebbene il file non sia più su disco o minidisco la data non è stata cancellata 
e può essere letta utilizzando la procedura PATCH. 


ERASE specifica che l’entrata VTOC per il file, la libreria o la cartella deve essere 
rimossa. Ciò lascia spazio nella VTOC e sul disco per altri dati. Inoltre, i dati 
che erano contenuti nel file, nella libreria o nella cartella cancellati sono rimos- 
si. E cioè tutti i caratteri nel file, nella libreria o nella cartella sono sostituiti con 
zeri (ERASE impedisce a chiunque di leggere i dati usando una procedura di si- 
stema ad esempio PATCH, che può visualizzare tutto ciò cHe c'è sul disco 0 
sul minidisco). 


mmggaa, ggmmaa o aammgg specifica la data di creazione del file da cancellare. 
Per i file su disco, la data specificata deve essere nello stesso formato della 
data di sessione. Per un file su minidisco, la data specificata deve essere nel- 
lo stesso formato della data di creazione del file sul minidisco. 


Se una libreria viene cancellata dal disco (ed è specificato LIBR), non è pos- 
sibile specificare una data. 


Note: 


1. Se non è specificata alcuna data ed esiste più di un file sul disco col 
nome specificato, l'operatore può cancellare tutti i file con quel nome 
o cancellare il lavoro. 

2. Se non è specificata alcuna data e sul minidisco esiste più di un file 
con il nome specificato, soltanto i! primo file (in termini di locazione) 
con il nome specificato, viene cancellato. Il primo file è determinato 
dal posizionamento fisico del file sul minidisco, E’ possibile determinare 
il posizionamento dei file sul minidisco usando la procedura CATALOG 
per listare le entrate per locazione. 


LIBR specifica che una libreria deve essere cancellata dal disco. Se non è specifi- 
cato LIBR o FOLDER dal disco deve essere cancellato un file. LIBR può essere 
specificato soltanto se è specificato F1 


FOLDER specifica che una cartella deve essere cancellata dal disco. Se non è 
specificato LIBR o FOLDER, dal disco deve essere cancellato un file. FOLDER 
può essere specificato soltanto se è specificato F1. 


ALL specifica che file, librerie e cartelle, che sono membri di un gruppo di file, devono 
essere cancellati dal disco. ALL può essere specificato soltanto se è specifica- 


to F1. 
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locazione iniziale specifica la locazione iniziale di un alimentatore a minidisco che 
deve essere usata dalla procedura DELETE. Se non viene specificato questo 
parametro, si assume 51, Questo parametro è ignorato se il sistema non ha 
un modulo a caricatore. La locazione iniziale deve essere minore della loca- 
zione finale. 


locazione finale specifica la locazione finale di un alimentatore a minidischi che 
deve essere usata dalla procedura DELETE. Se questo parametro non è 
specificato, si presume la locazione iniziale. Questo parametro è ignorato 
se il sistema non ha un modulo a minidischi a caricatore. La locazione finale 
(se specificata), deve essere maggiore o identica alla locazione iniziate e non 
deve provocare un salto dagli alimentatori del minidisco (S1, S2 e S3) agli 
alimentatori del caricatore (M1 e M2). Cioè la specifica di una locazione 
iniziale di 53 e di una locazione finale di M1, non è ammessa. E’ possibile 
specificare una locazione iniziale nel caricatore 1 e una locazione finale nel 
caricatore 2. 


Le locazioni iniziali e finali possono essere una fra le seguenti: 
S1, S2 o S3 specifica uno dei tre alimentatori di un minidisco. 


M1 o M2 specifica uno dei due alimentatori del caricatore. Se M1 o M2 sono spe- 
cificati come locazione iniziale e non è specificata alcuna locazione finale, 
viene elaborato l'intero caricatore (tutti i dieci alimentatori). Specificare M1 
o M2 come locazione finale, equivale a specificate rispettivamente M1.10 o 


M2.10. 


M1.nn o M2.nn indica una posizione specifica nell'ambito di un caricatore. nn è 
un numero che va da 01 a 10 e indica la posizione nell’ambito del caricatore. 


id volume specifica l'ID di volume di uno o più minidischi da elaborare. L’ID di 
volume è usato per assicurarsi che vengano elaborati i minidischi corretti. 
Deve essere immesso un ID di volume se il primo parametro è ALL e il se- 
condo parametro è |1. 


Se l'ID di volume specificato corrisponde all’ID di volume dei minidischi, i 
file sono cancellati. Se l'ID di volume specificato non corrisponde all’ID di 


volume dei minidischi, viene visualizzato un messaggio e l'operatore può in- 
serire i minidischi corretti o cancellare la procedura. 


nome gruppo specifica il gruppo di file da cancellare dal disco. Per esempio, per 
cancellare i file AB.F1 e AB.F2, che costituiscono il gruppo di file AB, oc- 
correrebbe immettere AB senza il punto, li primo parametro deve essere 
ALL; il secondo parametro deve essere F1. 
Esempio 1 


Cancellazione del file denominato PAYROLL dal minidisco nell’alimentatore 1. 


DELETE PAYROLL, ,REMOVE 


Esempio 2 
Cancellazione dal disco della libreria denominata MYLIB. 


DELETE MYLIB,F1,,,LIBR 


Esempio 3 
Cancellazione dal disco della cartella denominata MYLIB, 


DELETE MYLIB, F1,,,,FOLDER 


Esempio 4 


Cancellazione di tutti i file su minidisco con un ID di volume di VOL001. Il mi- 
nidisco è nell’alimentatore 2. 


DELETE ALL,I1,,,,92,,VOLOO1l 


Esempio 5 


Cancellazione dal disco di tutti i file nel gruppo di file denominato FIL. 1 file in 
questo gruppo sono denominati FIL.A, FIL.B e FIL.C. 


DELETE ALL,F1,,,,30FIL 


Esempio 6 


Cancellare tutti i file dai minidischi nell’alimentatore 1 dalla posizione 1 fino alla 
posizione 5. | minidischi hanno un ID di volume di VOL001. 


DELETE ALL,I1,REMOVE,,,M1.01,M1.05,VOLOO1l 


Esempio 7 


Rimuovere il file PAYROLL dai minidisco e cancellare tutti i dati che erano con- 
tenuti nel file, Il minidisco è nell’alimentatore 1. 








DELETE PAYROLL, ,ERASE 
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PROCEDURA DELNRD 


La procedura DELNRD rimuove dal disco l’indirizzario risorse di rete (#NRD.FLE). 
L'indirizzario non può essere rimosso mentre viene utilizzato da un altro lavoro. 


Per maggiori informazioni vedere il manuale Distributed Data Management Guide. 


La procedura DELNRD esegue il programma di utilità # SINDL. 


DELNRD 


La procedura DELNRD non ha parametri. 


PROCEDURA DFU 


La procedura DFU visualizza un menù dal quale è possibile selezionare un'’opzio- 
ne per eseguire un programma DFU esistente o creare o modificare un program- 
ma DFU. Usando il programma DFU è possibile creare, aggiornare, listare o vi- 
sualizzare dati in un file su disco. DFU significa programma di utilità per file di 
dati. Per ulteriori informazioni su DFU, vedere il manuale Programma di utilità 


per file di dati (DFU). 





Esempio 


Questo esempio mostra come visualizzare il menù DFU. 


DFU 
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PROCEDURA DFULOAD 


La procedura DFULOAD crea una libreria denominata #DFILIB e copia il sup- 
porto DFU da minidisco in quella libreria. DFULOAD copia ulteriore supporto 
nella libreria di sistema (#LIBRARY). La procedura DFULOAD può copiare 
minidischi PID (Programming Information Department) o minidischi creati dalla 
procedura DFUSAVE. Vedere la Procedura DFUSAVE per informazioni sul mo- 
do in cui salvare il supporto DFU su minidisco. 


La procedura DFULOAD può modificare il record di configurazione principale 
con il risultato che potrebbe non esserci un membro di configurazione corrispon- 
dente. Per modificare il membro di configurazione per farlo corrispondere al re- 
cord di configurazione principale, vedere il manuale Modifica della configurazione 
del sistema. Occorre normalmente usare la procedura CNFIGSSP per aggiungere 
supporto al sistema, E’ possibile usare la procedura DFULOAD per ripristinare il 
supporto che era stato precedentemente salvato dalla procedura DFUSAVE. 


| Se il DFU non è in uso corrente sui sistema, si deve utilizzare la procedura TOLIBR 
per copiare il file minidisco DFU nella libreria # LIBRARY prima di eseguire DFULOAD. 


| Se #LIBRARY con il DFU era stata salvata e poi ripristinata prima di eseguire DFU- 
LOAD, non è necessario copiare il file minidisco DFU con la procedura TOLIBR. 


DEFULOAD 





A1, A2, A3 o A4 indica la preferenza del disco; cioè l’unità disco che viene esa- 
minata per prima alla ricerca di spazio disponibile. Se non è disponibile suf- 
ficiente spazio su quell’unità, vengono esaminate le altre unità (se presenti) 
e #DFULIB viene inserito sull'unità disco meno usata. Se non è specificata 
alcuna locazione ed il sistema ha più di un'unità disco, #DFULIB è inserito. 
sull'unità disco meno usata, 


A1 specifica che # DFULIB deve essere inserito sul primo disco, se è disponibi- 
le spazio. i 


A2 specifica che #DFULIB sarà inserita su! secondo disco, se è disponibile 
spazio. 


A3 specifica che #DFULIB sarà inserita sul terzo disco, se è disponibile spazio. 


AA specifica che # DFULIB sarà inserita sul quarto disco, se è disponibile spazio. 


S1, S2 o S3 specifica l'alimentatore per minidischi contenente il primo minidisco 


da usare. Se non è specificata alcuna posizione di minidisco, si presume S1. 
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M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidi- 
sco da usare. M1 indica il primo caricatore e M2 indica il secondo caricatore. 
nn è un valore decimale da 01 a 10 che identifica la locazione del minidisco 


nel caricatore. Specificare M1 equivale a specificare M1.01. Specificare M2 
equivale a specificare M2.01. 


Esempio 


Creazione di #DFULIB su disco e copia del supporto DFU da minidisco. 
DFULOAD 


PROCEDURA DFUSAVE 


La procedura DFUSAVE copia il supporto DFU su minidisco. Viene copiato il 
supporto DFU dalle librerie #DFULIB e #LIBRARY. E' possibile usare la Proce- 
dura DFULOAD per caricare il supporto DFU da minidisco, Il minidisco destina- 


to a contenere la copia salvata deve avere come ID di volume PPUTIL ed essere 
inserito nell’alimentatore S1. 


DFUSAVE 


La procedura DFUSAVE non ha parametri. 
Esempio 


Copia del supporto DFU su minidisco. 


DFUSAVE 
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PROCEDURA DICTLOAD 


La procedura DICTLOAD crea una libreria per uno specifico linguaggio e copia il sup- 
porto del dizionario per il DW/36 da minidisco nella libreria. Può copiare sia i minidi- 
schi inviati dal Centro Distribuzione IBM che quelli creati dalla procedura DICTSAVE. 
Vedere la procedura DICTSAVE più avanti per informazioni su come salvare un di- 
zionario su minidisco. 


La procedura DICTLOAD potrebbe modificare il record principale di configurazione, 
con il risultato di non avere più corrispondenza con il membro di configurazione. 
Per modificare quindi il membro di configurazione vedere il manuale Modifica Con- 
figurazione di Sistema. Normalmente si utilizza la procedura CNFIGSSP per aggiun- 
gere supporto al sistema. È possibile usare la procedura DICTLOAD per ripristinare 
il supporto che era stato salvato con la procedura DICTSAVE. 


DICTLOAD | DANISH 7411, 
ENGLISH A2 
FRENCH A3 


FRENCHCA A4 
GERMAN 
ITALIAN 
SPANISH 





DANISH specifica che deve essere copiato il dizionario danese. Viene creata una 
libreria denominata #TUDAN ed il supporto viene copiato dal minidisco sulla 
libreria. 


ENGLISH specifica che deve essere copiato il dizionario inglese. Se è specificato 
INGLESE, la procedura DICTLOAD crea una libreria denominata # TUENG e co- 
pia il supporto dal minidisco sulla libreria 


FRENCH specifica che deve essere copiato il dizionario francese. Viene creata 
una libreria denominata #TUFRN ed il supporto viene copiato dal minidisco sulla 
libreria. 


FRENCHCA specifica che deve essere copiato il dizionario francese - canadese. Viene 
creata una libreria denominata # TUFRC ed il supporto viene copiato dal mini- 
disco sulla libreria. 


SPANISH specifica che deve essere copiato il dizionario spagnolo. Viene creata 
una libreria denominata # TUSPN ed il supporto viene copiato dal minidisco sulla 
libreria. 


GERMAN specifica che deve essere copiato il dizionario tedesco. Viene creata una 
libreria denominata # TUGER ed il supporto viene copiato dal minidisco sulla 
libreria. 


ITALIAN specifica che deve essere copiato il dizionario italiano. Viene creata una 


libreria denominata # TUITN ed il supporto viene copiato dal minidisco sulla li- 
breria. 


248.1 


248.2 


A1, A2, A3 o AA indica la preferenza del disco; cioè l’unità disco che viene 
esaminata per prima alla ricerca di spazio disponibile. Se non è disponibile suf- 
ficiente spazio su quell’unità, vengono esaminate le altre unità (se esistono) e 
la libreria è inserita sull'unità disco meno usata. Se non viene specificata nes- 
suna locazione, ed il sistema ha più di una unità disco, la libreria viene inserita 
sull'unità disco meno usata. 


A1 specifica che se c’è spazio disponibile, la libreria viene inserita sul primo disco. 


A2 specifica che se c'è spazio disponibile, la libreria viene inserita sul secondo 
disco. 


A3 specifica che se c’è spazio disponibile, la libreria viene inserita sul terzo disco. 


A4 specifica che se c'è spazio disponibile, la libreria viene inserita sul quarto 
disco. 


S1, S2 o $3 specifica l'alimentatore a minidischi contenente il primo minidisco che deve 
essere usato. Se non è specificata alcuna posizione di minidisco, si assume S1. 


M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidisco da 
usare. M1 indica il primo caricatore e M2 indica il secondo caricatore. nn è un valo- 


re decimale da 01 a 10 che identifica la locazione del minidisco nel caricatore. M1 
equivale a specificare M1.01; M2 equivale a specificare M2.01. 


Esempio 


Creazione di # TUENG su disco e copia del dizionario inglese da minidisco. 


PROCEDURA DICTSAVE 


La procedura DICTSAVE copia un dizionario per DW/36 su minidisco. Vedere la pro- 
cedura DICTLOAD per la libreria associata al dizionario specificato. Si può usare la 
procedura DICTLOAD per caricare il supporto del dizionario dal minidisco di riserva. 


DICTSAVE | DANISH | S1 


ENGLISH S2 
FRENCH S3 


FRENCHCA M1.nn 
GERMAN M2.nn 
ITALIAN 
SPANISH 





DANISH specifica che deve essere salvato il dizionario danese. L'ID di volume del 
minidisco deve essere PPDAN. 


ENGLISH specifica che deve essere salvato il dizionario inglese. L'ID volume del 
minidisco deve essere PPENG. 


FRENCH specifica che deve essere salvato il dizionario francese. L'ID volume del 
minidisco deve essere PPFRN. 


FRENCHCA specifica che deve essere salvato il dizionario francese canadese. L’ID di 
volume del minidisco deve essere PPFRC. 


GERMAN specifica che deve essere salvato il dizionario tedesco” L'ID di volume dei 
minidisco deve essere PPGER. 


ITALIAN specifica che deve essere salvato il dizionario italiano. L"ID di volume del 
minidisco deve essere PPITN. 


S1, S2 o S3 specifica l'alimentatore a minidischi contenente il primo minidisco che deve 
essere usato. Se non è specificata alcuna posizione di minidisco, si assume S1. 


M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidisco da 
usare. M1 indica il primo caricatore e M2 indica il secondo caricatore. nn è un vaio- 
re decimale da 01 a 10 che identifica la locazione del minidisco nel caricatore. M1 
equivale a specificare M1.01; M2 equivale a specificare M2.01. 


248.3 
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PROCEDURA DISABLE 


La procedura DISABLE interrompe o disabilita un sottosistema SSP-ICF, MSRJE 
o un'emulazione di unità 3270. Vedere uno dei seguenti manuali per ulteriori in- 
formazioni: 

e Per informazioni su SSP-ICF, vedere manuale SSP-/CF Reference, 

e Per informazioni su MSRJE, vedere il manuale MSAVE Guide, 

e Per informazioni sull'emulazione di unità 3270, vedere manuale 3270 Guide, 
Se è attiva la riservatezza mediante parola d'ordine, questa procedura può essere 
eseguita soltanto da un operatore classificato come operatore di sistema o più 
elevato. La procedura DISABLE può essere eseguita da qualsiasi unità video ma 
solo da una unità video alla volta. 


Se ci sono sessioni di comunicazione attive, DISABLE visualizza un messaggio 
che prevede le seguenti opzioni: 


O Congelamento della disabilitazione; non devono iniziare nuove sessioni. Il 
sistema continuerà la disabilitazione quando le sessioni di comunicazioni 
correnti terminano. ° 


1. Riprova della disabilitazione e nuovo controllo per le sessioni attive. 


2 Termine immediato delle sessioni attive e continuazione della disabilita- 
zione. 


3 Termine della procedura DISABLE. La richiesta di disabilitazione è igno- 
rata. La procedura DISABLE è cancellata e il sottosistema rimane abi- 
litato. 


La procedura DISABLE esegue il programma di utilità $IEDS. 


DISABLE nome configurazione sottosistema, [ nome locazione | 





nome configurazione sottosistema indica la configurazione di sottosistema da di- 
sabilitare. 


. nome locazione specifica la locazione a distanza da disabilitare. Il sottosistema ri- 
mane abilitato finché ci sono altre locazioni attive. 


Esempio 
Disabilitazione della configurazione di sottosistema SUB1. 


DISABLE SUB1 
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PROCEDURA DISPLAY 
La procedura DISPLAY è supportata soltanto per compatibilità con il Sistema/34 


della IBM. Vedere la Procedura LISTDATA per informazioni sul modo in cui vi- 
sualizzare o stampare un file su disco o su minidisco. 


| PROCEDURA DSU 


re membri di procedura e membri origine utilizzando il programma di utilità di sup- 
porto alla programmazione DSU. 


Per maggiori informazioni vedere il manuale Programma di utilità di supporto alla 


| La procedura DSU consente di creare, preparare, rimuovere, visualizzare o stampa- 


programmazione, SC13-5139. 


I Per preparare un membro di procedura o membro origine con il DSU: 





| Per creare, preparare, visualizzare, stampare o cancellare un membro di libreria con 
it DSU: 





membro non esiste, viene creato. Se non viene indicato alcun nome di mem- 


| EDIT specifica che è iniziata una sessione di edit per il membro specificato. Se il 
bro, viene visualizzato lo schermo Lavoro con membro di libreria. 


LIBRARY fornisce lo schermo Lavoro con membri di libreria che elenca i membri di 
| una libreria specificata o assunta automaticamente. Da quello schermo è pos- 
sibile creare, preparare, visualizzare, stampare o cancellare un membro di libreria. 
nome membro specifica il membro origine o di procedura che si vuole creare o pre- 
parare. ll primo carattere deve essere alfabetico (da A a Z, #, @, $) e il nome 
non può contenere spazi in bianco, virgole o apici {'). Se il nome non viene spe- 
cificato, viene visualizzata una lista di membri della libreria. 


nome libreria specifica la libreria che contiene o conterrà il membro di libreria da 
| modificare o creare. Se non viene specificato aicun nome di libreria, viene as- 
sunta la libreria in uso corrente. 


tipo specifica il tipo di membro DSU da listare, creare o preparare. Se LIBRARY è 
specificato come primo parametro, P e S sono voci valide. Immettere una P 
in questo campo vuol dire che devono essere listati i membri di procedura. Im- 
mettere una S vuol dire che devono essere listati i membri origine. Spazio in 
bianco indica che si vogliono listare sia i membri di procedura che quelli origine. 
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Se come primo parametro è stato specificato EDIT, sono valide le voci che 
seguono: 


A specifica un programma RPGII con specifiche di auto report. 

F. specifica un membro origine di libreria con specifiche di formato video. 
P. specifica un membro di procedura. 

R. specifica un membro origine che contiene un programma RPGII. 

S specifica un membro origine di libreria. 

T. specifica un membro origine messaggi. 

W. specifica un membro origine contenente specifiche WSU. 


membro formato specifica il nome del membro oggetto formato video creato, da 
usare dal DSU, per preparare specifiche origine o di procedura. 


lunghezza specifica specifica la lunghezza di ogni specifica origine o di procedura. 
{ tipi di membro da A a R devono avere lunghezza massima da 80 a 96. | tipi 
membro T da 40 a 80; tutti gli altri possono essere lunghi da 40 a'120 carat- 
teri. Se deve essere creato un nuovo membro, i valori che è possibile specifica- 
re o quelli che il DSU assume se non viene indicata la lunghezza della specifica 
sono: 


Lunghezza specifica Lunghezza specifica 
Tipo membro ammessa ammessa 


SOURCE, S da 40 a 120 
da 40 a 120 
da 80 a 96 
da 40 a 120 
da 80 a 96 
da 40 a 120 
da 40 a 120 























File origine analizzato specifica il nome del file contenente le specifiche origine ana- 
lizzate ed i messaggi diagnostici. Questo parametro è utilizzato dalle procedu- 
re RPGONL, COBOLONL, e FORTONL per la creazione e la stampa del membro 
origine analizzato. Il file deve essere stato creato da un compilatore, ad esem- 
pio RPG richiamato dalla procedura RPGONL. Se viene specificato un file ori- 
gine analizzato, il DSU usa quel file come immissione e consente di effettuare 
modifiche. Quando il DSU termina, il file unitamente a tutte le modifiche ap- 
portate, sostituisce il membro origine specificato nel primo parametro. 


Esempio 1 


Questo esempio mostra come creare o preparare per la stampa il membro origine 
ACCTREVC nella libreria ACCTLIB. 


DSU EDIT, ACCTREVC,5S,,, ACCTLIB 
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| Esempio 2 


Questo esempio mostra come listare sul terminale tutti i membri di procedura della 
libreria ACCTLIB. Si può scegliere se si vuole preparare, visualizzare, stampare o 
cancellare i membri. 


| DSU LIBRARY,ACCTLIB,P 


|] PROCEDURA DSULOAD 


La procedura DSULOAD crea una libreria denominata # DSULIB e copia il program- 
ma di utilità di supporto alla programmazione (DSU) dal minidisco in quella libreria. 
Crea inoltre le librerie #DSULB1 e #DSULB2, se queste già no esistono. Queste 
due librerie contengono i profili dell'utente. La procedura DSULOAD copia anche 
supporto aggiuntivo sulla libreria di sistema (#LIBRARY). Può copiare minidischi 
forniti dal Centro Distribuzione IBM o minidischi creati dalla procedura DSUSAVE. 


La procedura DSULOAD potrebbe modificare il record di configurazione principale, 
col risultato che potrebbe non esserci un corrispondente membro di configurazio- 
ne. Per modificare il membro di configurazione e per farlo corrispondere al record 
di configurazione principale, vedere il manuale Modifica della configurazione del si- 
stema. Si dovrebbe normalmente usare la procedura CNFIGSSP per aggiungere sup- 
porto al sistema. È possibile usare la procedura DSULOAD per ripristinare il suppor- 
to che era stato precedentemente aggiunto. 


DSULOAD 





A1,A2,A30 A4 indica la preferenza del disco; cioè l’unità disco che viene esami- 
nata per prima alla ricerca di spazio disponibile. Se non è disponibile spazio a 
sufficienza su quell'unità, vengono esaminate altre unità (se esistono) e # DSU- 
LIB viene inserito sull'unità disco meno usata. Se non è specificata alcuna lo- 
cazione ed ìl sistema ha più di una unità disco, # DSULIB viene inserito sull’u- 
nità disco meno usata. 


A1 specifica che #DSULIB deve essere inserito sul primo disco, se è disponi- 
bile spazio. 


A2 specifica che #DSULIB deve essere inserito sul secondo disco, se è dispo- 
nibile spazio. 


spazio. 


A4 specifica che #DSULIB deve essere inserito sul quarto disco se è disponi- 
bile spazio. 


S1, S2, o $3 specifica l'alimentatore a minidischi contenente il primo minidisco da 


| A3 specifica che # DSULIB deve essere inserito sul terzo disco se è disponibile 
| usare. Se non è specificata alcuna posizione di minidisco, si presume S1. 
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M1. nn o M2. nn specifica la locazione di caricatore contenente il primo minidisco 
da usare. M1 indica il primo caricatore, M2 indica il secondo. nn è un valore 
decimale da 01 a 10 che identifica la locazione del minidisco nel caricatore. 
M1 equivale a specificare M1.01; M2 equivale a specificare M2.01. 

| Esempio 


| Creazione di #DSULIB su disco e copia del supporto DSU da minidisco. 


| DSULOAD 


| PROCEDURA DSUSAVE 
La procedura DSUSAVE copia il programma di utilità di supporto alla programma- 
zione (DSU) su minidisco. Il supporto DSU viene copiato dalle librerie # LIBRARY 
e #DSULIB. È possibile usare la procedura DSULOAD per caricare il supporto DSU 


dai minidischi di riserva. Il minidisco destinato a contenere la copia salvata deve 
avere come !D di volume PPDS1. 


| DSUSAVE 


| La procedura DSUSAVE non ha parametri. 


| Esempio 
] Copia del supporto DSU dalle librerie #LIBRARY e #DSULIB su minidisco. 


| DSUSAVE 


PROCEDURA EDITNRD 
La procedura EDITNRD crea e prepara l'emissione dell'indirizzario risorsa di rete 
{#NRD.FLE). Nel preparare l'emissione si possono aggiungere, variare, scegliere, 
cancellare e stampare le entrate dell'indirizzario. La procedura EDITNRD è interatti- 
va: il sistema chiede di immettere fe informazioni appropriate. 


Per maggiori informazioni vedere il manuale Distributed Data Management Guide. 


La procedura EDITNRD esegue il programma di utilità $SINR. 


EDITNRD 


È una procedura senza parametri. 
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PROCEDURA EM3270 


La procedura EM3270 collega o scoliega un'unità video o una stampatrice al sot- 
tosistema emulazione unità: BSC 3270. Prima di poter immettere questa proce- 
dura; il sottosistema BSC 3270 deve essere abilitato, 


Vedere il manuale 3270 Guide per ulteriori informazioni sulla procedura EM3270 
e sull’emulazione di unità 3270. 


Per collegare o scollegare un'unità video: 


EM3270 [ia terminale rideo|, ON , nome locazione] s| messaggi visualizzati 


OFF YES 


NO 





L'operatore che si sta collegando sulla propria unità video deve immettere sol- 
tanto EM3270. 


id terminale video specifica l'ID del terminale dell'unità video da collegare o scol- 
legare da parte dell’emulazione di unità BSC 3270. Se l’unità video che viene 
collegata è quella dalla quale viene immessa la procedura, questo parametro 
non è richiesto. Se l'ID dell'unità video è quello di un'altra unità video, deve 
trattarsi di un'unità video per l'immissione dati che non è correntemente in 
uso o di un'unità video comandi in modo attesa. 


ON specifica che si desidera collegare un'unità video ad una emulazione di unità 
BSC 3270. Se non viene immesso alcun parametro, si presume ON. 


OFF specifica che si vuole scollegare un’unità video dall’emulazione di unità BSC 
3270. 


nome locazione specifica il nome di locazione associato con questa sessione. Il 
nome di locazione è definito durante la configurazione del sottosistema e si 
riferisce al nome della locazione a distanza con la quale deve avvenire la co- 
municazione. 


YES o Y specifica che i messaggi devono essere visualizzati. Se non viene immes- 
so alcun parametro si presume YES. 


NO o N specifica che i messaggi non devono essere visualizzati. 


Per collegare o scollegare una stampatrice: 


YES 
NO 


stampatrice, A | pone Locazione], stampa differita 
OFF 


differimento stampa differita|,|priorità 
YES 2 
NO 





250 


id stampatrice specifica l'ID di terminale della stampatrice da collegare o scolle- 
gare. Se l'emissione della stampatrice per questa stampatrice non deve essere 
differita, la stampatrice non deve essere in uso, 


ON specifica che si vuole collegare una stampatrice ad un'emulazione di unità 
BSC 3270. Se non viene immesso alcun parametro, si presume ON. 


OFF specifica che si vuole scollegare una stampatrice dall’emulazione di unità 
BSC 3270. 


nome lacazione specifica il nome di locazione associato con questa sessione, Il 
nome di locazione è definito durante la configurazione del sottosistema e si 
riferisce alla locazione a distanza con la quale deve avvenire la comunicazione. 


stampa differita specifica se l'emissione verso la stampatrice deve essere differita. 
E’ possibile specificare YES o NO. Se il differimento non è attivo, questo 
parametro è ignorato. 


YES o Y specifica che l'emissione deve essere differita. Se non viene specifi- 
cato alcun parametro, si presume YES. 


NO o N specifica che l'emissione non deve essere differita. 


differimento della stampa differita specifica quando deve essere stampata l’emis- 
sione differita. E’ possibile immettere YES o NO. Se il differimento non è 
attivo, questo parametro viene ignorato. 


YES o Y indica che la stampa dell'emissione stampata deve attendere fino a 
che la stampatrice non è scollegata dall'emulazione di unità BSC 3270. Se 
non viene immesso alcun parametro, si presume YES. 


NO o N indica che la stampa dell'emissione differita non deve attendere fino 
a che la stampatrice non è scollegata dall'emulazione di unità 3270. Cioè l’e- 
missione deve essere stampa non appena possibile, 

priorità specifica la priorità per l'emissione differita. La priorità è un numero da 
O a 5, con 5 che rappresenta la priorità più elevata (stampata per prima), 1 
ta priorità meno elevata e 0 per indicare che l'emissione deve essere congelata 
fino a che non viene immesso un comando RELEASE per consentire la stam- 
pa dell'emissione. Se questo parametro non viene specificato, si presume 1. 
Se il differimento non è attivo, questo parametro è ignorato. 


Esempio 1 


Questo esempio mostra come collegare l'unità video all’emulazione di unità 3270. 


EM3270 


Esempio 2 
Questo esempio mostra come collegare la stampatrice P3 all'emulazione di unità 
3270. L'emissione stampata deve essere differita e qualsiasi emissione deve essere 


stampata non appena possibile. 


EM3270 P3,0N,,,NO 
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PROCEDURA ENABLE 


La procedura ENABLE avvia o abilita un sottosistema di comunicazioni, Deve esse- 
re eseguita la procedura ENABLE prima di poter usare un sottosistema. Per ulteriori 
informazioni vedere il manuale Using System/36 Communications. 


| Questa procedura può essere eseguita su qualsiasi unità video ma può essere ese- 
guita soltanto una procedura ENABLE alla volta. 


La procedura ENABLE esegue il programma di utilità $IENBL. 


ENABLE nome configurazione sottosistema,|nome libreria + [numero linea], 
libreria corrente 





NOSHOW|, [none locaz ione| 
SHOW 





nome configurazione sottosistema specifica la configurazione di sottosistema da 


abilitare. Questo è il nome specificato quando è stata eseguita la procedura 
CNFIGICF per configurare il membro di sottosistema. 


nome libreria specifica la libreria contenente la configurazione di sottosistema. Se 
non è specificato alcun nome di libreria, si presume la libreria corrente. 


numero linea specifica il numero della linea di comunicazione da usare per il sotto- 
sistema. Se si sta abilitando il sottosistema Intra, occorre omettere questo 
parametro. 


NOSHOW specifica che i parametri configurati per un particolare sottosistema 
non devono essere visualizzati. Se non viene specificato alcun parametro, si 
presume NOSHOW. 


SHOW specifica che devono essere visualizzati tutti i parametri configurati per un 
particolare sottosistema. Non è possibile modificare alcuno di questi parame- 
tri. Per una descrizione dei parametri che vengono visualizzati, vedere uno 
dei manuali sopra citati. 


nome locazione specifica la locazione da attivare. La locazione è attivata se non 
è già abilitata. ; 
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Esempio 


Nell'esempio che segue, la procedura ENABLE, abilita ‘il sottosistema specificato 
dal membro di configurazione SUB1 trovato nella libreria denominata MYLIB, 
SUB1 deve usare la linea di comunicazione 1 e i parametri per questa configura- 
zione devono essere visualizzati. 


ENABLE SUBl ,MYLIB,1,SHOW 
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PROCEDURA ENTER 


La procedura ENTER consente di creare un file su disco usando il DEU. Vengo. 
no usate le specifiche di file per definire il formato dei record nel file. Per ulte- pe 
riori informazioni sul DFU, vedere Programma di utilità per file di dati {DFU). 


nome file,nome programma dfu,| nome membro file origine | . 


numero di record, |D| ,|NN , none membro origine aful "i 
Z NY 
B YN 
YY 
GO 


nome libreria sl nome membro origine tracciato video |,l nome file su disco 
libreria corrente 





nome file specifica il file da creare. Il nome file può contenere da 1 a 8 caratteri 
alfanumerici. 


nome programma dfu specifica il programma DFU da creare per elaborare il file. 
Se nella libreria il programma non esiste, il. DFU avvia le procedure d'impo- 
stazione. Se nella libreria il programma esiste, il DFU crea direttamente il file. 


nome membro file origine specifica il membro origine che contiene la descrizione 
del file (specifica F) e le descrizioni dei record d’immissione (specifiche 1) 
che descrivono il file da elaborare. Questo membro può contenere uno o più 
serie di descrizioni di file e di specifiche di immissione o un intero program- 
ma RPG II. La descrizione del file e le specifiche di immissione che corri- 
spondono al file sono considerate come descrizione dei dati. 


Se non viene specificato, questo parametro è richiesto. Questo parametro è 
richiesto se il programma specificato non esiste. 


numero di record specifica il numero massimo di record che si desidera immette- 
re nel file. Questo parametro è richiesto. Se il parametro non è specificato, 
viene richiesto. Il DFU consente un massimo di 8.000.000 di record in un file. 


carattere riempimento indica se i campi numerici non a chiave devono essere 
riempiti con zeri (esadecimale FO) o con spazi in bianco. Le sole entrate am- 
messe sono D, Z o B. Se non è specificato alcun parametro, si presume D. 


D o B specifica un file di dati con riempimento di spazi vuoti dei campi nu- 
merici senza chiave. 


Z specifica un file di dati con riempimento di zeri dei campi numerici senza 
chiave. 
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NN, NY, YN, YY, o GO indica come devono essere elaborate le specifiche origi- 
ne DFU, Questo parametro è usato se il programma non esiste e deve essere 
eseguita l'impostazione del programma. Indica se le specifiche DFU per que- 
sto programma sono già memorizzate nella libreria e se devono essere memo- 
rizzate nella libreria quando l'impostazione del programma è completo; Que- 
sto membro origine delle specifiche DFU, è memorizzato o cercato nella li- 
breria corrente, a meno che non sia specificato un nome di libreria. 


NN: le specifiche DFU memorizzate non sono usate da questa impostazione 
di programma. Viene richiesto di creare le specifiche ma queste non vengono 


salvate nella libreria. 


NY: le specifiche DFU memorizzate non sono usate da questa impostazione 
di programma. Viene richiesto di creare le specifiche; una volta create, sono 
memorizzate nella libreria. 


YN: per l'impostazione di questo programma sono usate le specifiche DFU 
memorizzate. Non viene effettuata alcuna richiesta ma è possibile aggiornare 
le specifiche richiamate prima che venga creato il programma, Se si modifi- 
cano le specifiche sull'unità video, viene interessato soltanto questo program- 
ma; le modifiche non sono memorizzate nella libreria. 


YY: per questa impostazione di programma sono usate le specifiche DFU 
memorizzate. Non viene effettuata alcuna richiesta ma è possibile aggiornare 
le specifiche richiamate prima che venga creata la descrizione di formato. Le 
specifiche nella libreria sono sostituite dalie specifiche aggiornate. 


GO: per questa impostazione di programma sono usate le specifiche DFU 
memorizzate. Non viene effettuata alcuna richiesta e non è possibile aggior- 
nare le specifiche prima che venga creato il programma a meno che non si 
trovino errori. Se si trovano errori nelle specifiche, l'operatore deve correg- 
gere la specifica prima di creare il programma, In ogni caso, le specifiche 
DFU memorizzate non vengono cambiate. 


nome membro origine file specifica il membro origine che contiene o conterrà 
le specifiche DFU salvate. Questo parametro è richiesto se il parametro di 
elaborazione origine DFU non è NN, 


nome libreria specifica la libreria contenente o destinata a contenere le specifiche 
DFU. Tutti i membri di libreria associati con il lavoro DFU sono cercati o 
memorizzati in questa libreria. Se non viene specificato questo parametro, si 
presume la libreria corrente. 


nome membro origine tracciato video specifica il membro origine in cui DFU de- 
ve memorizzare le specifiche origine tracciato video che sono state create 
quando è stato impostato un lavoro DFU. Se viene specificato questo para- 
metro, è possibile cambiare in un secondo tempo le specifiche origine trac- 
ciato video generate, compilarle per sostituire il membro oggetto tracciato 
video esistente e quindi eseguire lo stesso programma DFU con i dati visua- 
lizzati nei campi ridefiniti. 


nome file su disco specifica il nome da listare nella VTOC del disco per il file da creare, 
se questo è diverso da nome indicato nel programma DFU. Questo è un parametro 
opzionale. Se si specifica questo parametro e non il file da creare con il programma 
DFU, quel parametro viene richiesto. 
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Esempio 


Questo esempio mostra come creare un file su disco denominato FILE1; usando 
un membro origine di file denominato RPGPROG. Il file deve contenere 100 
record e specifiche DFU denominate DFUSETUP devono essere salvate dopo es- 
sere state create. La libreria MYLIB contiene il membro origine file e conterrà 
le specifiche DFU. 


ENTER FILE1,DFILFMT,RPGPROG,100,,NY,DFUSETUP,MYLIB,DFILFMTI 


| PROCEDURA EPDOWNL 


| La procedura EPDOWNL copia la parte PC dell’emulazione 3278 via IBM Personal 
Computer dal Sistema/36 al Personal Computer IBM. 


Per maggiori informazioni, vedere il manuale 3278 Emulation via IBM Personal Com- 
puter User's Guide, SCO9-1086. 


EPDOWNL 


| La procedura EPDOWNL non ha parametri. 


| PROCEDURA EP3270 


La procedura EP3270 collega un Personal Computer IBM con l'emulazione unità 
SNA 3270. Prima di attivare questa procedura, deve essere abilitato il sottosiste- 
ma, SNA 3270. 

Per maggiori informazioni sulla procedura EP3270 e l'emulazione unità 3270, ve- 
dere il manuale 3278 Emulation via IBM Personal Computer User's Guide. 


EP3270 [rome ubicazione | 





nome ubicazione specifica l'ubicazione associata alla sessione. Il nome ubicazione 
viene definito durante la configurazione del sottosistema e fa riferimento al no- 
me dell'ubicazione remota. Questo parametro può mancare se solo una ubica- 
zione remota di emulazione unità SNA 3270 viene abilitata. 


| £sempio 
Î Questo esempio mostra come collegare un Personal Computer IBM con l’emulazio- 
ne unità SNA 3270. 


| EP3270 
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PROCEDURA ERR 


La procedura ERR fa sì che venga visualizzato il messaggio di errore specificato 
e consente all'operatore di scegliere un'opzione: 0, 1, 2, 3 o D. li messaggio spe- 
cificato viene richiamato dal membro di messaggi di livello uno dell'utente cor- 
rente. Ciò consente alle procedure di visualizzare i messaggi ed emettere opzioni 
allo stesso modo in cui il sistema visualizza messaggi di errore. 


Per informazioni sull’assegnazione del membro di messaggi USER1, vedere Spe- 
cifica OCL MEMBER, 


La procedura ERR esegue il programma di utilità $CPPE. 


id messaggio, | opzioni], | ‘testo: | 
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Le 





id messaggio specifica il codice di identificazione del messaggio da visualizzare. 
Questo parametro è un numero da 1 a 4 cifre con valori da da 0 a 9.999. 


opzioni specifica le opzioni da visualizzare con il messaggio. Le opzioni possono 
essere qualsiasi combinazione di 0, 1, 2 o 3 ma i numeri devono essere im- 
messi in ordine ascendente e senza spazi in bianco o altri caratteri. Per esem- 
pio, per far visualizzare le opzioni 1 e 3, immettere 13. Se non sono specifi- 
cate opzioni, si presume l'opzione 3. 


Se viene selezionata l'opzione 3 da un operatore, la procedura viene cancel- 
lata immediatamente; cioè il controllo non viene riportata alla procedura, Se 
l'operatore sceglie un'opzione 1 o 2, viene impostato un codice di ritorno, E’ 
possibile usare l’espressione ?CD? in una procedura per controllare l'opzione 
scelta da un operatore. li valore è impostato come segue: 


Valore codice 


Opzione ritorno ?CD? 
0 1010 
1 1011 

1012 


Vedere la sezione Espressioni di sostituzione per ulteriori informazioni sulle e- 
spressioni di sostituzione. 


Se l'operatore sceglie l'opzione D, la procedura viene immediatamente cancellata 
e viene eseguita una copia della memoria dell'attività. 


testo specifica che il testo sostituirà i caratteri # nel messaggio. E’ possibile speci- 


ficare un massimo di 75 caratteri che devono essere racchiusi tra apici (’). Gli 
apici intermedi non sono ammessi. 
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Esempio 


L'esempio che segue mostra una procedura che visualizza un messaggio di errore 
dal membro di messaggi MESSAGES se l'operatore non ha immesso SOURCE o 
PROC come secondo parametro. Cioè se il parametro 2 non è uguale a SOURCE 
o PROC. ll messaggio visualizzato è il numero 0020 dal membro di messaggi di 
livello 1 denominato MESSAGES. Le opzioni ammesse sono 9, 1 e 3. 


e Se è immessa l'opzione 1, il parametro 2 (P2) conterrà SOURCE. 
e Se è immessa l'opzione 1, ii parametro 2 {P2) conterrà PROC. 
® Se è immessa l'opzione 3, la procedura viene automaticamente cancellata. 


// MEMBER USERI-MESSAGES 

// IFF ?22=SOURCE IFF ?2?=PROC ERR 0020,013 
// IF ?CD?=1010 EVALUATE P2='SOURCE'! 

// IF ?CD?=1011 EVALUATE P2='PROC' 

LISTLIBR ?1?,22?,MYLIB 


Se l'operatore non immettesse un secondo parametro, il messaggio 0020 potrebbe 
essere visualizzato come segue: 


USER-0020 (01 3) 
SOURCE or PROC must be entered. 0=SOURCE, 1=PROC, 3=Cancel 


Le specifiche origine contenute nel membro MESSAGES, sono: 


MESSAGES,l 
0020 SOURCE or PROC must be entered. O0=SOURCE, 1=PROC, 3=Cancel 
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PROCEDURA ES3270 
La procedura ES3270 collega o scollega un'unità video o una stampatrice dal sot- 
tosistema emulazione unità SNA 3270. Prima di poter immettere questa procedu- 
ra, il sottosistema SNA 3270 deve essere abilitato. 


Vedere il manwale 3270 Guide per ulteriori informazioni sulla procedura ES3270 
e sull'emulazione di unità 3270, 


Per collegare o scollegare un'unità video: 


ES3270 fia terminale video] [ON |, [pone locazione] 5 [ia stempatrice| 


OFF 





id terminale video specifica l'ID di terminale dell'unità video da collegare o scol- 
legare dall'emulazione di unità SNA 3270. Se l’unità video che viene colle- 
gata è quella dalla quale viene immessa la procedura, il parametro non è ri- 
chiesto. Se l'ID dell'unità video è quello di un'altra unità video, deve trattar- 
si di un'unità video per immissione dati non correntemente in uso o di una 

* unità video comandi nel modo attesa, 


ON specifica che si desidera collegare un'unità video ad una emulazione di unità 
SNA 3270. Se non viene immesso alcun parametro, si presume ON. 


OFF specifica che si vuole scollegare un'unità video dall'emulazione di unità 
SNA 3270. 


nome locazione specifica il nome di locazione associata a questa sessione. 


Il nome di locazione è definito durante la configurazione del sottosistema e 
fa riferimento al nome della locazione a distanza con la quale deve avvenire 
la comunicazione. Se è attivo solo un sottosistema di emulazione unità SNA 
3270, non occorre specificare questo parametro. 


id stampatrice specifica l'ID di terminale di una stampatrice che deve essere usata 
per una funzione di copia iniziata dall’elaboratore principale. Questo parame- 
tro corrisponde alla matrice di autorizzazione di stampa usata da 3274. Se 
non viene immesso alcun parametro, si presume la stampatrice di sessione as- 
sociata con l’unità video. 
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Per collegare o scollegare una stampatrice: 


ES3270 id stampatrice,|ON + [none locazione| ,| stampa differita, 
OFF YES 
NO 


differimento stampa differita|,| priorità|,|posizioni|,|linee per 
YES 1 132 pagina 


NO 





id stampatrice specifica l'ID di terminale per la stampatrice da collegare e scolle- 
gare dall'emulazione di unità SNA 3270. Se l'emissione della stampatrice per 
questa stampatrice non viene differita, la stampatrice non deve essere in uso. 


ON specifica che si vuole collegare una stampatrice ad un'emulazione di unità 
SNA 3270. Se non viene immesso alcun parametro, si presume ON. 


OFF specifica che si vuole scollegare una stampatrice dall’emulazione di unità 
SNA 3270. 


nome locazione specifica il nome di locazione associato a questa sessione. Il no- 
me di locazione è definito durante la configurazione del sottosistema e si ri- 
ferisce al nome della locazione con la quale deve avvenire la comunicazione. 
Se è attivo soltanto un sottosistema emulazione di unità SNA 3270, non oc- 
corre specificare questo parametro. 


stampa differita specifica se l'emissione verso la stampatrice deve essere differita. 
E’ possibile specificare YES (Y) o NO (N). Se il differimento non è attivo, il 
parametro è ignorato. YES specifica che l'emissione deve essere differita; NO 
specifica che l'emissione non deve essere differita. Se non viene specificato 
alcun parametro, si presume YES. 


differimento stampa differita specifica quando deve essere stampata l'emissione 
differita. E’ possibile immettere YES (Y ) o NO (N). Se il differimento non 
è attivo, questo parametro è ignorato. YES indica che la stampa dell’emissio- 
ne differita deve attendere fino a che la stampatrice non si è scollegata da 
SNA 3270. NO indica che la stampa dell'emissione differita non deve atten- 
dere fino a che la stampatrice non è scollegata da SNA 3270. Cioè che l’e- 
missione deve essere stampata non appena è possibile. Se non viene immesso 
alcun parametro, si presume YES. 


priorità specifica la priorità per l'emissione differita. La priorità è un numero da 
O a 5, in cui 5 rappresenta la priorità più elevata (stampata per prima), 1 la 
priorità più bassa e 0 per indicare che l'emissione deve essere congelata fino 
a che non viene immesso un comando RELEASE per consentire la stampa 
dell'emissione. Se questo parametro non viene specificato, si presume 1, Se 
il differimento non è attivo, questo parametro è ignorato. 


posizioni specifica il numero di posizioni di stampa in una riga. E’ possibile spe- 
cificare qualsiasi numero decimale da 1 a 132. Se non viene specificato alcun 
parametro, si presume 132. Questo parametro si applica soltanto quando si 
sta effettuando Il collegamento di una stampatrice che userà stringhe di ca- 
ratteri SNA (un dispositivo della stampatrice 3287). 
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linee per pagina specifica il numero di righe per pagina, E’ possibile indicare 
qualsiasi numero decimale da 1 a 255, Se non viene immesso alcun parame- 
tro, viene presunto il numero di righe corrente per pagina. Questo parametro 
si applica soltanto quando si effettua il collegamento di una stampatrice che 
userà le stringhe di caratteri SNA (un dispositivo della stampatrice 3287). 


Esempio 1 


Questo esempio mostra come coliegare l’unità video all'emulazione di unità 3270. 


ES3270 


Esempio 2 


Questo esempio mostra come collegare la stampatrice P3 all'emulazione di unità 
3270. L'emissione stampata deve essere differita, e qualsiasi emissione deve essere 
stampata non appena possibile. 


ES3270 P3,0N,,,N0 


PROCEDURA EXTRACT 


La procedura EXTRACT è supportata soltanto per compatibilità con il Sistema/34 
della IBM (il sistema/36 non permette di specificare dati esadetimali in una proce- 
dura, pertanto il settimo parametro nella procedura EXTRACT non può contenere 
dati esadecimali). Vedere la Procedura COPYDATA per informazioni sulla copia di 
file di dati. Vedere la Procedura LISTDATA per informazioni sulla lista dei file di dati. 


Pia 


PROCEDURA FORMAT 


La procedura FORMAT elabora le specifiche origine create denominate specifiche 
tracciato video, Le specifiche di tracciato video definiscono come devono essere 
visualizzate le informazioni sull'unità video. E’ possibile usare SEU o SDA per 
creare le specifiche tracciato video. Quando si usa SDA, non occorre usare la pro- 
cedura FORMAT. 


Per informazioni sulle specifiche tracciato video e per le liste campione della pro- 
cedura FORMAT, vedere il manuale Guida alla definizione dei tracciati video. 


La procedura FORMAT esegue quanto segue: 


e Crea un nuovo membro oggetto tracciati video contenente i tracciati definiti 
dalle specifiche origine. Tutti i tracciati usati da un programma, possono es- 
sere disposti in uno o più membri oggetto di tracciato video. E’ possibile 
inserire fino a 255 tracciati video in un solo membro. 


@ Aggiunge uno o più tracciati video a un membro oggetto tracciati video esi- 
stente. 


e Sostituisce uno o più tracciati video in un membro oggetto tracciati video 
esistente. 


e Cancella un tracciato video da un membro oggetto tracciati video esistente, 


Quando si genera un membro oggetto tracciati video, il numero di riferimento 
assegnato al membro origine è assegnato anche al membro oggetto generato. 
Ciò consente, confrontando i due numeri di riferimento, di determinare se viene 
usato un vecchio livello di membro oggetto. 


La procedura FORMAT esegue il programma di utilità $SFGR. 


Per creare, aggiungere o aggiornare un membro oggetto tracciato video: 


CREATE |, nome membro oggetto,/libreria membro oggetto|, 
ADD zibreria corrente 


UPDATE 


,nome membro origine, [libreria membro origine |, numero di formati 


libreria corrente 1 


[REPLACE] s| HALT s |PRINT 
nai NOHALT NOPRINT 
PARTIAL 
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FORMAT 


Per cancellare un tracciato da un membro oggetto tracciati video: 


DELETE,nome membro oggetto,]jlibreria membro oggetto], nome formato 


libreria corrente video 








CREATE specifica che deve essere creato un nuovo membro oggetto tracciato 
video. Se non viene specificato alcun parametro, si presume CREATE. 


ADD specifica che deve essere aggiunto uno o più tracciati video ad un esistente 
membro oggetto tracciati video. 


UPDATE specifica che devono essere sostituiti uno o più tracciati video in un 
membro oggetto tracciati video esistente. 


DELETE specifica che un singolo tracciato video deve essere rimosso da un mem- 
bro oggetto tracciati video. Se il tracciato rimosso era il solo del membro, 
l'intero membro oggetto tracciati video viene rimosso dalla libreria. 


nome membro oggetto specifica il membro oggetto tracciati video da creare, ag- 
giornare, aggiungere o cancellare. 


libreria membro oggetto specifica il nome della libreria che deve contenere (o che 
contiene) il membro oggetto tracciati video. Se non è specificato un nome di 
libreria, si presume la libreria corrente. 


nome membro origine specifica il nome del membro origine di libreria che contie- 
ne le specifiche dei tracciati video. 


libreria membro origine specifica il nome della libreria che contiene il membro 
origine. Se noti è specificato un nome di libreria, si presume la libreria corrente. 


numero di formati indica il numero dei tracciati video contenuti nel membro ori- 
gine tracciati video. Questo numero è usato per determinare la quantità di 
spazio di file di lavoro temporaneo richiesto dalla procedura FORMAT. Mag- 
giore è il numero immesso e maggiore sarà lo spazio del file sul disco tempo- 
raneo usato. Se il numero dei tracciati video non è specificato, si presume 1. 
II numero di tracciati deve essere indicato soltanto se viene specificato 


CREATE o ADD. 


REPLACE specifica che se esiste già un membro oggetto con lo stesso nome del 
membro oggetto tracciati video che viene creato, il membro oggetto esistente 
deve essere sostituito dalla procedura FORMAT. REPLACE è usato soltanto 
se viene specificato CREATE; se viene specificato UPDATE o ADD, REPLA- 
CE è ignorato. 


Se REPLACE non è specificato ed esiste un membro oggetto duplicato, viene 
visualizzato un messaggio. L'operatore può quindi sostituire il membro ogget- 
to esistente con il membro oggetto tracciato video creato o terminare il la- 
voro. 


HALT specifica che deve essere visualizzato un messaggio che indica che si sono 
incontrati errori di avvertimento e di terminazione durante l'elaborazione del 
membro origine tracciato video. Se viene visualizzato un messaggio indicante 
un avvertimento, l'operatore può continuare il lavoro o cancellare il lavoro. 
Se viene visualizzato un messaggio indicante un errore di terminazione, l’ope- 
ratore può soltanto cancellare il lavoro. Se non viene immesso alcun parame- 
tro, si presume HALT. 


NOHALT specifica che non deve essere visualizzato nessun messaggio che indichi 
che si è incontrato un errore di avvertimento o di terminazione durante l’ela- 
borazione di un membro origine tracciato video. Per gli errori di avvertimen- 
to, il passo di lavoro è completato e sono generati i tracciati video. Per gli er- 
rori di terminazione, il passo di lavoro viene terminato e non vengono gene- 
rati tracciati video. 


Nota: per gli errori di terminazione, l’espressione di sostituzione ?CD?, è im- 
postata a 1008; vedere la sezione Espressioni di sostituzione per ulteriori in- 
formazioni. 


PRINT specifica che deve essere stampato quanto segue: 
e ll nome del membro origine tracciato video 
e Le specifiche tracciato video Se D 


e Qualsiasi messaggio di errore di terminazione, di avvertimento o informa- 
tivo i 


e Le descrizioni dei campi di emissione e di immissione 


e Una lista degli indicatori di tracciato video usati 


e | nomi delle librerie di emissione e di immissione 
e li nome del membro oggetto tracciato video 
e Il fabbisogno di memoria per ciascun formato 


e La lunghezza della stringa di dati per ciascun tracciato 


® li numero di byte di memoria di testo esplicativo 
Se non viene immesso alcun parametro, si presume PRINT. 


NOPRINT specifica che quando si incontra un errore di terminazione nelle spe- 
cifiche origine, devono essere stampate soltanto la specifica errata e il mes- 
saggio dell'errore di terminazione. Se non si trovano errori, non viene stam- 
pato nulla. * 


PARTIAL specifica che deve essere stampato quanto segue: 
e Il nome del membro origine tracciato video 


e Qualsiasi messaggio di terminazione o di avvertimento unitamente alla spe- 
cifica che provoca il messaggio o qualsiasi messaggio informativo 


e | nomi delle librerie di immissione e di emissione 


e Il nome del membro aggetto tracciato video 


nome formato video indica il nome del tracciato video da cancellare. 
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Esempio 1 


Creazione di un nuovo membro oggetto tracciati video denominato FORMAT2 
nella libreria denominata MYLIB. Le specifiche di tracciato video definiscono tre 
tracciati video e sono in un membro origine denominato INPUT. Il membro ori- 
gine è nella libreria denominata MYLÎIB. 


FORMAT CREATE,FORMAT2,MYLIB,INPUT,MYLIB,3 


Esempio 2 


Aggiornamento di un membro oggetto tracciati video esistente denominato FOR- 
MAT? nella libreria MYLIB. Il membro origine contenente le specifiche dei trac- 
ciati video è denominato SCREEN ed è a sua volta contenuto nella libreria 
MYLIB. 


FORMAT UPDATE,FORMAT2,MYLIB,SCREEN,MYLIB 


Esempio 3 
L'esempio che segue mostra come rimuovere un tracciato video denominato 


SCREENI1 dal membro oggetto tracciati video denominato FORMAT2. Il mem- 
‘bro oggetto è nella libreria denominata MYLIB. 


FORMAT DELETE,FORMAT2,MYLIB,SCREENI 


Esempio 4 


Aggiunta ad un esistente membro oggetto tracciati video denominato FORMAT2 
nella libreria MYLIB. Il membro origine contenente le specifiche tracciato video é 
denominato SCREEN ed è pure contenuto nella libreria MYLIB. 


FORMAT ADD,FORMAT2,MYLIB, SCREEN,MYLIB 


PROCEDURA FORTC 


Questa procedura è supportata soltanto per compatibilità con il Sistema/34 della 
IBM. La procedura che si deve usare per compilare un programma FORTRAN sul 
Sistema/36 è la Procedura FORTRANC. 


PROCEDURA FORTGC 


Questa procedura -è supportata soltanto per compatibilità con il Sistema/34 della 
IBM. La procedura che si deve usare per compilare un programma FORTRAN sul 
Sistema/36 è la Procedura FORTRANC. La procedura che si deve usare per ese- 
guire un programma FORTRAN sul Sistema/36 è la Procedura FORTGO. 


PROCEDURA FORTG 


Questa procedura è supportata soltanto per compatibilità con il Sistema/34 della 
IBM. La procedura che occorre usare per eseguire un programma FORTRAN sul 
Sistema/36 è la Procedura FORTGO. 


Cali 





PROCEDURA FORTGO 


La procedura FORTGO esegue Un programma FORTRAN. Per informazioni su 
FORTRAN, vedere il manuale Programming with FORTRAN IV. 


nome membro oggetto ,[none procedura] ,,, nome libreria 
° libreria corrente 


#HMAIN 





nome membro oggetto specifica il membro oggetto di libreria che contiene il 
programma FORTRAN da eseguire. 


nome procedura specifica il membro di procedura di libreria che contiene una o 
più specifiche OCL per il programma. Questa procedura può contenere qual- 
siasi specifica OCL che può essere inserita tra una coppia di specifiche OCL 
LOAD e RUN. ; 


nome libreria specifica la libreria che contiene il membro oggetto FORTRAN e il 
membro di procedura. Se questo parametro non viene specificato, la ricerca 
viene effettuata nella libreria corrente e quindi nella libreria di sistema 


(FLIBRARY). 


N specifica che il lavoro non deve essere disposto nella coda dei lavori. Se non 
viene immesso alcun parametro, si presume N. 


Y specifica che il lavoro deve essere inserito nella coda dei lavori. 


Esempio 
Questo esempio mostra come eseguire un programma FORTRAN denominato 
PAYROLL che è contenuto nella libreria corrente. Il membro di procedura deno- 
minato PAYPROC contiene le specifiche OCL usate dal programma. 


FORTCO PAYROLL,PAYPROC 
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PROCEDURA FORTLOAD 


La procedura FORTLOAD crea una libreria denominata #FORTLIB e copia da 
minidisco il supporto FORTRAN IV in quella libreria FORTLOAD copia ulte- 
riore supporto nella libreria di sistema (#LIBRARY). La procedura FORTLOAD 
può copiare minidischi PID (Program Information Department) o minidischi crea- 
ti dalla procedura FORTSAVE. Vedere la Procedura FORTSAVE per informazio- 
ni sul modo in cui salvare su minidisco il supporto FORTRAN IV. 


La procedura FORTLOAD potrebbe modificare il record di configurazione principale 
con il risultato che potrebbe non esserci un corrispondente membro di configura- 
zione. Per modificare il membro di configurazione per adeguarlo al record di confi- 
gurazione principale, vedere il manuale Modifica della configurazione del sistema. 
Occorre normalmente usare la procedura CNFIGSSP per aggiungere supporto al si- 
stema. È possibile usare la procedura FORTLOAD per ripristinare il supporto che 
era stato precedentemente salvato dalla procedura FORTSAVE. 


FORTLOAD 








A1, A2, A3 o AA indica la preferenza del disco; cioè l’unità disco che viene esa- 
minata per prima nella ricerca di spazio disponibile. Se non è disponibile suf- 
ficiente spazio su quell’unità, vengono esaminate le altre unità {se esistono) 
e #FORTLIB viene inserito sull'unità disco meno usata. Se non è specificata 
alcuna locazione ed il sistema dispone di più di un'unità disco, #FORTLIB 
è inserita sull'unità disco meno usata. 


A1 specifica che #FORTLIB deve essere inserita sul primo disco, se è di- 
sponibile spazio. 


A2 specifica che #FORTLIB deve essere inserita sul secondo disco, se è 
disponibile spazio. 


A3 specifica che #FORTLIB deve essere inserita sul terzo disco, se è di- 
sponibile spazio. 


A4 specifica che #FORTLIB deve essere inserita sul quarto disco, se è di- 
sponibile spazio. 


S1, $2 o S3 specifica l'alimentatore a minidischi contenente il primo minidisco 
da usare. Se non è specificata alcuna posizione di minidisco, si presume S1. 


M1.nn o M2.nn specifica la locazione del caricatore che contiene il primo mini- 
disco da usare. M1 indica il primo caricatore e M2 indica il secondo. nn è un 
valore decimale da 01 a 10 che identifica ia locazione del minidisco nel cari- 
catore. Specificare M1 equivale a specificare M1.01. Specificare M2 equivale 
a specificare M2.01. 
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Esempio 


Creazione di #FORTLIB su disco e copia del supporto FORTRAN IV da mini 


sco. 


FORTLOAD 


PROCEDURA FORTONL 


La procedura FORTONL consente di sviluppare un programma FORTRAN. E’ 
possibile creare un nuovo programma o effettuare qualsiasi modifica ad un pro- 
gramma esistente. La procedura FORTONL fa comparire una serie di schermi 
che consentono di immettere, compilare e modificare programmi FORTRAN,. 


Per ulteriori informazioni sul FORTRAN, vedere il manuale Programming with 
FORTRAN IV. 


FORTONL 
La procedura FORTONL non ha parametri. 
Esempio 
Per sviluppare un programma FORTRAN, immettere: 
FORTONL 
PROCEDURA FORTP 
La procedura FORTP provoca la visualizzazione di un menu che consente di 
selezionare la funzione FORTRAN che si desidera eseguire. E’ possibile. immet- 
tere, compilare, eseguire o modificare programmi FORTRAN. 
FORTP 


La procedura FORTP non ha parametri. 


Esempio 


Per visualizzare il menù FORTP, immettere: 


FORTP 
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PROCEDURA FORTRANC 


La procedura FORTRANC compila un programma FORTRAN. Per informazioni 
sul FORTRAN, vedere it manuale Programming with FORTRAN IV. 


FORTRANC nome membro origine,|libr. membro origine |,|libreria membro oggetto), 





libreria corrente libreria corrente 


NODSM |,| PRINT » MAP » | SOURCE si TEST s{HALT s | OBJECT , 
DSM CRT NOMAP| {NOSOURCE NOTEST NOHALT NOOBJECT 
3 NOPRINT = 


ho 


LINK i libreria sottoroutine ,| ampiezza file di lavoro 
K 


NOLIN 





nome membro origine specifica il membro origine di libreria da compilare. 


libreria membro origine specifica il nome della libreria che contiene il membro 


origine da compilare. Se non è specificato questo parametro, si presume la 
libreria corrente. 


libreria membro oggetto specifica il nome della libreria che contiene o che deve 
contenere la sottoroutine compilata o il membro oggetto. Se questo para- 
metro non è specificato, si presume la libreria corrente. Notare che se nella 
specifica *PROCESS nel programma origine è specificato un nome di libreria, 
verrà usata quella libreria. 


NODSM specifica che non deve essere prodotto alcun membro origine analizzato. 
Se non viene specificato alcun parametro, si presume NODSM. 


DSM specifica che la procedura FORTRANC deve produrre un membro origine 
analizzato del programma FORTRAN. Viene usato il programma di utilità 
$MAINT per sostituire il membro origine originale con il membro origine 
analizzato. Le specifiche che contengono errori sono precedute da una spe- 
cifica con due punti interrogativi (??) nelle posizioni 1 e 2 nel membro ori- 
gine. Vedere il manuale Programming with FORTRAN IV per ulteriori infor- 
mazioni sul membro origine analizzato, 


PRINT specifica che deve essere stampata la lista del compilatore. Se non viene 
specificato alcun parametro, si presume PRINT, 


NOPRINT specifica che non deve essere stampata alcuna emissione. 


CRT specifica che deve essere visualizzata la lista del compilatore sull'unità video 
che sta eseguendo la procedura FORTRAN. 


MAP o NOMAP specifica se le variabili e le specifiche nel programma FORTRAN 
devono essere prodotte su una mappa. Se non viene specificato né MAP né 
NOMAP, deve essere usato il parametro indicato nella specifica *PROCESS 
del programma FORTRAN. MAP specifica che deve essere prodotta una 
mappa delle variabili e delle specifiche NOMAP specifica che non deve essere 
prodotta alcuna mappa delle variabili e delle specifiche. 


SOURCE o NOSOURCE specifica se devono essere incluse le specifiche origine 
FORTRAN nella stampa prodotta dal compilatore. Se non viene specificato 
né SOURCE né NOSOURCE viene usato il parametro indicato nella specifica 
*PROCESS del programma FORTRAN. SOURCE indica che le specifiche 
FORTRAN devono essere incluse nella lista, NOSOURCE indica che non de- 
vono essere incluse specifiche FORTRAN. 


TEST o NOTEST indica se devono essere elaborate specifiche DEBUG nel pro- 
gramma. Se non viene specificato né TEST né NOTEST, viene usato il para- 
metro indicato nella specifica *PROCESS del programma FORTRAN. TEST 
indica che qualsiasi specifica DEBUG deve essere compilata. NOTEST indica 
che non deve essere compilata alcuna specifica DEBUG. 


HALT o NOHALT specifica il messaggio che viene visualizzato se nel programma 
vengono trovati errori che provocano l'interruzione o i’arresto della compila- 
zione. Se non viene specificato né HALT né NOHALT, viene usato il para- 
metro indicato nella specifica *PROCESS del programma FORTRAN. HALT 
indica che la procedura FORTRANC deve visualizzare il messaggio ed inter- 
rompersi se vengono trovati errori nel programma che viene compilato. 
NOHALT specifica che la procedura FORTRANC deve visualizzare il messag- 
gio ma non si deve interrompere. 


OBJECT o NOOBJECT specifica se la procedura FORTRANC deve produrre un 
membro di sottoroutine dal programma compilato. Se non viene specificato 
alcun parametro, viene usato quello indicato nella specifica “PROCESS del 
programma FORTRAN. 


OBJECT specifica che deve essere creaio un modulo oggetto. Se il membro 
origine è un programma principale FORTRAN il modulo oggetto deve essere 
sottoposto a edizione di moduli oggetto usando l’editore di moduli oggetto 
a sovrapposizione (la procedura OLINK), prima di poterlo eseguire, Ciò con- 
sente di effettuare modifiche alle sottoroutine che il programma principale 
può richiamare senza dover compilare il programma principale; occorre sol- 
tanto compilare le sottoroutine ed effettuare l'edizione dei moduli oggetto 
dei programma principale. 


Se il membro origine è una sottoroutine FORTRAN, questo è il solo tipo di 
modulo che può essere creato. Questo modulo può essere sottoposto ad edi- 
zione di modulo oggetto con un programma principale sia compilando il pro- 
gramma principale (specificando LINK) sia usando l'editore di moduli og- 
getto a sovrapposizione. 


IH modulo oggetto è catalogato come membro di sottoroutine di libreria. Se 
esiste un membro di sottoroutine nella libreria di emissione specificata, il 


membro esistente viene sostituito dal programma compilato più recentemente, 


NOOBJECT specifica che non deve essere creato un modulo oggetto. 
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LINK o NOLINK specifica se la procedura FORTRANC deve eseguire l'edizione 


di moduli oggetto a sovrapposizione come parte della compilazione. Se non 
viene indicato alcun parametro, viene usato quello indicato nella specifica 
*PROCESS del programma FORTRAN, Questo parametro è valido soltanto 
per ì programmi principali FORTRAN. 


LINK specifica che deve essere eseguita l'edizione di moduli oggetto a so- 
vrapposizione. Il modulo oggetto compilato è sottoposto a edizione di modu- 
lo oggetto per produrre un membro oggetto eseguibile, Se nella libreria di 
emissione specificata esiste un membro oggetto, è sostituito con il program- 
ma di recente compilato e sul quale è stata eseguita l’edizione dei moduli 


oggetto. 


NOLINK specifica che non deve essere eseguita l'edizione dei moduli oggetto 
a sovrapposizione. 


nome libreria sottoroutine specifica la libreria che contiene una o più sottorouti- 


ne da sottoporre a edizione moduli oggetto con il programma che viene com- 
pilato. Se non viene specificato alcun parametro, viene usato quello indicato 
nella specifica *PROCESS del programma FORTRAN. 


ampiezza file di lavoro indica la dimensione del file di lavoro FORTRANC in 


blocchi. E’ possibile immettere qualsiasi numero da 1 a 9999. Se non viene 
specificato alcun parametro, si presumono 40 blocchi. 


MRO o NOMRO specifica se il compilatore è da usarsi con strutture overlay resi- 


Esempio 


denti in memoria. Se non viene specificato alcun parametro, viene assunto 
NOMRO. 


MRO specifica che il compilatore è da usarsi con strutture overlay residenti in me- 
moria. 


NOMRO specifica che il compilatore non è da usarsi con strutture overlay residenti 
in memoria. 


Questo esempio mostra come compilare un programma FORTRAN denominato 
PAYROLL. Questo esempio mostra: 


Che il programma è nella libreria corrente. 
Che deve essere prodotto un membro origine analizzato. 


Che non deve essere prodotta alcuna lista dei compilatore (il membro origi- 
ne analizzato sarà usato per correggere eventuali errori). 


Non deve essere prodotta alcuna mappa delle specifiche o delle variabili. 
Deve essere compilata qualsiasi specifica DEBUG. 
La procedura FORTRANC deve continuare se si trovano degli errori. 


Non devono essere creati membri oggetto o di sottoroutine. 


FORTRANC PAYROLL,,,DSM,NOPRINT,NOMPA,,TEST,NOHALT,NOOBJECT,NOLINK 


FE, 


FORTSAVE 


PROCEDURA FORTSAVE 
La procedura FORTSAVE copia su minidisco il supporto FORTRAN IV. Viene copia- 
to il supporto FORTRAN IV dalla libreria # FORTLIB e # LIBRARY. È possibile usare 
la Procedura FORTLOAD per caricare il supporto FORTRAN IV dal minidisco di riser- 


va. |l minidisco destinato a contenere la copia salvata deve avere come ID di volu- 
me PPFORT e deve essere disposto sull’alimentatore a minidischi $1. 


La procedura FORTSAVE non ha parametri. 


Esempio 
Copia su minidisco del supporto FORTRAN IV. 


FORTSAVE 
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FORTSDA 


PROCEDURA FORTSDA 


La procedura FORTSDA avvia la procedura SDA. Vedere il manuale Guida alla 
Definizione di Tracciati Video per ulteriori informazioni sul modo in cui usare lo 
SDA e per informazioni sui tracciati video. 


Vedere il manuale Programming with FORTRAN /V per ulteriori informazioni su 
questa procedura e sul FORTRAN, 


La procedura FORTSDA non ha parametri. 


Esempio 


Per avviare la procedura FORTSDA, immettere: 


FORTSDA 


ATTRA 


PROCEDURA FORTSEU 


La procedura FORTSEU consente di creare o modificare un programma 
FORTRAN usando il SEU, Per informazioni sul FORTRAN, vedere il manuale 
Programming with FORTRAN IV. Per ulteriori informazioni sul SEU, vedere il 
manuale Programma di Utilità per l'immissione di dati origine (SEU). 


FORTSEU nome membro ,|S}|,|membro formato seu, runghezza specifica], 
P #SE@XTRA 


nome libreria 
libreria corrente 








nome membro specifica il nome del membro di libreria da creare o da modificare. 


S specifica un membro origine FORTRAN. Se non è specificato alcun parametro, 
si presume S. 


P specifica un membro di procedura. 


membro formato seu specifica il nome del membro oggetto che contiene i for- 
mati SEU. Se non viene specificato alcun parametro, si presume #SE@ XTRA. 


lunghezza specifica indica la lunghezza di ciascuna specifica di procedura o origi- 
ne. Può trattarsi dì qualsiasi numero compreso fra 40 e 120. Se il membro 
esiste, si presume la lunghezza della specifica del membro. Se il membro vie- 
ne creato, il valore che è possibile specifica e i valori che sono assunti dal 
SEU se non è indicata alcuna lunghezza di specifica, sono i seguenti: 














Lunghezza specifica 
ammessa assunta 


da 80 a 96 96 


nome libreria specifica il nome della libreria che deve contenere o contiene il 
membro che viene creato o modificato. Se non viene specificato alcun nome 
di libreria, si presume la libreria corrente. 


Lunghezza specifica 














Esempio 
Questo esempio mostra come usare la procedura FORTSEU per modificare un 
membro origine FORTRAN denominato PAYROLL. La libreria corrente contiene 


il membro origine. 


FORTSEU PAYROLL 
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PROCEDURA FROMLIBR 


La procedura FROMLIBR copia uno o più membri di libreria su un file su disco, su 
minidisco, su nastro o nastro a cassetta. Questi file possono essere ricopiati sulla 
libreria usando la procedura TOLIBR. 


La procedura FROMLIBR non può copiare i membri di librerie forniti dalla IBM. Que- 
sti membri sono le procedure, i membri origine e i membri oggetto della IBM che 
vengono forniti insieme al SSP e ad altri programmi su licenza {ad esempio RPG o 
BASIC). Per copiare membri di libreria su licenza IBM, vedere l'appendice A. 


Per salvare un'intera libreria su minidisco, su nastro o nastro a cassetta (anche le librerie 
che contengono membri forniti dall'IBM), vedere la Procedura SAVELIBR. 


La procedura FROMLIBR esegue il programma di utilità $MAINT. 


| Per copiare o aggiungere uno o più membri di libreria al minidisco, al nastro o nastro a 
Cassetta. 


FROMLIBR nome membro »| SOURCE |,| nome file SE ,| giorni di validità], 
nome membro ,ALL\ |(S) nome membro| |T1\ |l 
ALL PROC [r2 ADD 
(P) 
LOAD 
(0) 
SUBR 
(R) 
LIBRARY 


id volume,|nome libreria ,|Sl , | AUTO | , | REWIND 
(0) 


libreria corrente; |S2 NOAUT LEAVE 
53 UNLOAD 
Ml.nn 
M2.nn 


]1unghezza record] 5 SWATTR- 
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Per copiare o aggiungere uno o più membri di libreria ad un file su disco sequen- 
ziale: 


FROMLIBR | nome membro È | SOURCE , ]nome file |, [blocchi 
nome membro ALL (S) nome membro 8 
ALL PROC 

(PI 

LOAD 

(0) 

SUBR 

(R) 

| BIBRARY 





nome libreria deus [ runghezza record | s |SVATTR 
libreria corrente 





nome membro specifica il membro di libreria da copiare dalla libreria. 


nome membro, ALL specifica che deve essere copiato uno o più membri di libre- 
i ria con nomi che iniziano con nome membro. li nome può contenere fino a 
7 caratteri. Per esempio: PAY,ALL specifica che devono essere copiati tutti i 
membri di libreria aventi nomi che iniziano con PAY, ad esempio PAYROLL, 
PAYCHECK o PAYRUN. 


ALL specifica che devono essere copiati dalla libreria tutti i membri di libreria. 


SOURCE o S specifica che devono essere copiati soltanto i membri origine. Se un 
parametro non viene specificato, si presume SOURCE. 


PROC o P specifica che devono essere copiati soltanto i membri di procedura. 
LOAD o O specifica che devono essere copiati soltanto i membri oggetto. 
SUBR o R specifica che devono essere copiati soltanto i membri di sottoroutine. 


LIBRARY specifica che devono essere copiati tutti i membri di libreria (origine, 
procedura, oggetto e sottoroutine). 


nome file specifica il file da creare. Se non è specificato il nome si presume il 
nome indicato per il membro di libreria o il nome parziale di membro. Se 
viene specificato ALL ma non è specificato alcun nome file, viene visualiz- 
zato un messaggio e l'operatore deve immettere il nome del file da creare, 
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11 specifica che uno o più membri di libreria devono essere inseriti in un nuovo 
file su minidisco o aggiunti ad un file su minidisco esistente. Se non viene 
specificato alcun parametro, si presume 11. 


F1 specifica che uno o più membri di libreria devono essere inseriti in un nuovo 
file su disco o aggiunti ad un file su disco esistente. 


T1 specifica che il nastro da usare per questa procedura si trova sull’unità nastro 
1. 


T2 specifica che il nastro da usare per questa procedura si trova sull'unità nastro 
2. 


TC specifica che per questa procedura deve essere usato un nastro a cassetta. 


giorni di validità specifica per quanto tempo il file su minidisco, su nastro o nastro a 
cassetta deve essere conservato. Tale valore può andare da 0a .999giorni. Se viene 
specificato | 1, T1, T20 TC e non sono specificati giorni di validità o ADD, si presu- 
me un giorno. Se è specificato un periodo di validità di 999 giorni, il file su minidi- 
sco, su nastro o nastro a cassetta è un file permanente. Per ulteriori informazioni 
sulla validità dei file su minidisco o su nastro, vedere la Specifica OCL FILE (peri fi- 
le su minidisco) e la Specifica OCL FILE {per i file su nastro). 


ADD specifica che devono essere aggiunti uno o più membri di libreria ad un 
file esistente che contiene membri di libreria. 


Nota: Quando vengono aggiunti membri ad un file su disco, il file deve con- 
tenere spazio inutilizzato sufficiente per accogliere i membri che vengono 
aggiunti. Quando vengono aggiunti i membri ad un file su minidiscg, su nastro 
o nastro a cassetta il file deve essere l’ultimo file attivo sul minidisco o sul nastro. 


id volume specifica l'ID di volume del minidisco, E’ possibile specificare da 1 a 
6 caratteri alfanumerici. Se non viene specificato 1'1D di volume, viene visua- 
lizzato un messaggio e l'operatore deve immetterio. 


T specifica che il file su disco contenente i membri di libreria deve essere un file 
residente. Se non viene immesso alcun parametro, si presume T e viene crea- 
to un nuovo file su disco. (Il file rimarrà sul disco al termine della procedura 
FROMLIBR). 


4 specifica che il file su disco contenente i membri di libreria deve essere un file 
di lavoro. Il file non esiste una volta che è terminato il lavoro contenente la 
procedura FROMLIBR. 


S specifica che il file su disco contenente i membri di libreria, deve essere un file 
temporaneo. ll file non esiste al termine della procedura FROMLIBR. 


Nota: per ulteriori informazioni sulla ritenzione dei file su disco (i parametri 
S, J e T), vedere la Specifica OCL FILE (per i file su disco). 


blocchi specifica la dimensione del nuovo file su disco da creare. Un blocco del 
disco contiene 2560 byte; un byte contiene un carattere. li valore dei bloc- 
chi è ignorato se viene specificato ADD. Se non viene specificato blocks, si 
presume una dimensione di 8 blocchi. 


nome libreria specifica la libreria contenente il membro o i diversi membri di li- 


breria da copiare. Se non è specificarto un nome di libreria, si presume la li- 
breria corrente. 


S1, S2 o S3 specifica l'alimentatore di minidisco contenente il primo minidisco 
dal quale devono essere elaborati i membri. Se non viene specificato alcun 
parametro, si presume S1. 


M1.nn o M2.nn specifica la locazione del caricatore che contiene il primo mini- 
disco dal quale i membri devono essere elaborati. M1 indica il primo carica 
tore e M2 indica il secondo caricatore. nn è un numero da 01 a 10 che iden- 
tifica la locazione del minidisco nei caricatore. Specificare M1 equivale a spe- 
cificare M1.01; specificare M2 equivale a specificare M2.01. 


AUTO specifica quanto segue: 


e Se vengono specificati S1, S2 o S3, possono essere usati tutti e tre i sin- 
goli alimentatori (51, S2 e S3). L'elaborazione inizia con il minidisco 
nell’alimentatore specificato e continua fino al minidisco nell’alimentato- 
re specificato e continua fino al minidisco nell’alimentatore S3. Se oc- 
corrono altri minidischi, viene visualizzato un messaggio e l'operatore 
deve inserire i successivi minidischi. L'elaborazione riprende col minidi- 
sco nell'alimentatore S1. 


e Se viene specificato M1.nn o M2.nn, è possibile usare entrambi gli ali- 
mentatori di caricatore (M1 e M2). L'elaborazione inizia con ii minidi- 
sco nella locazione specificata e continua fino al minidisco nella locazio- 
ne M2.10. Se occorrono altri minidischi, viene visualizzato un messaggio 
e l'operatore deve inserire i successivi minidischi. L'elaborazione ripren- 
de alla locazione M1.01, 


e Seviene specificato T1 o T2, quando la bobina nastro sull'unità nastro ori- 
ginale è terminata, il sistema passa all'altra unità nastro, se disponibile, 
per continuare l'elaborazione (da T1 a T2 o da T2 a T1). Se l'altra unità 
nastro non è disponibile, viene usata l’unità nastro originale. Una richiesta 
viene inviata per verificare che la bobina caricata sia quella giusta. 


e  Seèspecificato TC, il parametro AUTO/ NOAUTO viene ignorato in quanto vi 
è soltanto l’unità nastro a cassetta. i 


Se non è specificato alcun parametro, si presume AUTO. 
NOAUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, può essere usato soltanto l'alimentato- 
re specificato. Se occorrono altri minidischi, viene visualizzato un mes- 


saggio e l'operatore deve inserire il successivo minidisco nell’alimentatore 
specificato. 


e Se viene specificato M1.nn o M2.nn, può essere usato soltanto il carica- 
tore specificato. L'elaborazione inizia con il minidisco nella locazione 
specificata e continua fino all'ultimo minidisco nel caricatore. Se occor- 
rono altri minidischi, viene visualizzato un messaggio e l'operatore deve 
inserire il successivo caricatore nell’alimentatore di caricatore in uso. 
L'elaborazione riprende alla prima locazione nel caricatore. 


e Seè specificato T1 o T2, solo quell’unità nastro sarà usata per tutti i vo- 
lumi nastro, 


e Seè specificato TC, il parametro AUTO/ NOAUTO viene ignorato in quanto vi 
è soltanto l’unità nastro a cassetta. 


REWIND specifica che il nastro deve essere riavvolto dopo che è stata eseguita la 
procedura FROMLIBR. Si presume REWIND se questo parametro non viene 
specificato. Questo parametro non è ammesso se è specificato F1 o li. 


LEAVE specifica che il nastro deve essere lasciato dove si trova dopo che è stata 
eseguita la procedura FROMLIBR. L'operazione successiva inizia da quel pun- 
to. Questo parametro non è ammesso se è specificato F1 o 11. 
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UNLOAD specifica che il nastro deve essere riavvolto e scaricato dopo che è stata 


eseguita la procedura FROMLIBR. Questo parametro non è ammesso se è 
specificato F1 o 11. 
Se è specificato UNLOAD e TC, il nastro verrà riavvolto dopo l'elaborazione. 


lunghezza record specifica la lunghezza del record, in byte, dei membri origine o 


di procedura che vengono copiati. | membri sottoroutine e oggetto non vengo- 
no copiati. ll record può comprendere da 40 a 120 byte. Questo parametro 
deve essere specificato soltanto se si vorrà creare un file modo record. 


Il parametro lunghezza record può essere specificato soltanto con i membri ti- 
po SOURCE (S), PROC (P), o LIBRARY. | membri sono salvati nel modo record. 
Qualsiasi membro aggiunto al file modo record assumerà la lunghezza del re- 
cord specificato per il file. Qualsiasi altra lunghezza specificata con il parame- 
tro ADD verrà ignorata. Analogamente non deve essere specificata la lunghezza 
record quando viene aggiunto ad un file senza lunghezza record specificata. 
Membri TXT (prova) non vengono copiati. Se si tenta di copiare un membro 
TXT viene inviato un messaggio che permette di cambiare TXT in UNS (non 
specificato). 


Se non è specificata alcuna lunghezza record, i membri vengono copiati nel trac- 
ciato modo a settori. 


SVATTR specifica se gli attributi o indicatori di membri di libreria (SSP, MRT, PDA- 


TA, DATE, TIME, REF, SUB e HIST) devono essere salvati quando il membro 
viene copiato in formato record. SSP indica se il membro di libreria fa parte 
dell’SSP. MRT indica se il membro di libreria è una procedura a terminali richie- 
denti multipli (MRT). PDATA indica se il membro di procedura di libreria passa 
parametri o dati di programma quando il comando di procedura viene elabora- 
to. DATE indica la data in cui il membro è stato creato o è stato modificato 
per l’ultima volta. REF indica il numero di riferimento del membro. SUB indica 
il sottotipo del membro. HIST indica se le specifiche OCL del membro di proce- 
dura di libreria sono registrate su file cronologico. 


SVATTR è valido solo se viene specificata anche la lunghezza record. Si deve spe- 
cificare una lunghezza massima di 73 caratteri altrimenti viene inviato un messaggio 
d’errore. 


Questo parametro non è necessario se i membri vengono copiati in formato 
settore. Gli attributi vegono sempre copiati in modo settore. 


Esempio 1 


Questo esempio mostra come salvare un membro di procedura di libreria deno- 
minato TEST su un minidisco avente come ID di volume VOL0003. La procedu- 
ra si trova nella libreria denominata MYLIB e il minidisco è nel caricatore 2, po- 
sizione 5, 


FROMLIBR TEST,PROC,,I1,,VOLO03,MYLIB,M2.05,NOAUTO 


Esempio 2 


Si supponga che tutti i programmi origine di applicazione paghe e stipendi sia- 
no in una libreria denominata MYLIB e inizino con i caratteri PAY. Tutti i mem- 
bri di libreria devono essere copiati su un file su minidisco permanente. L'identi- 
ficazione del file sarà PAY e l'ID di voiume del minidisco è VOL001, Il minidi- 
sco è nell'alimentatore 1. 


FROMLIBR PAY,ALL,,,11,999,VOLOO1 ,MYLIB,S1,AUTO 


E 


Foe 


Esempio 3 


Questo esempio mostra come copiare un membro origine di libreria denominato 
SAMPLE su un nuovo file su disco denominato FILE1. 1l membro origine è nella 
libreria denominata MYLIB e il file su disco deve avere una dimensione di 4 bloc- 
chi, 


FROMLIBR SAMPLE, ,FILEl,F1,,},MYLIB 


Esempio 4 
Questo esempio mostra come aggiungere un membro origine di libreria denomina- 


to SAMPLE1 a un file su disco esistente denominato FILE1. Il membro origine si 
trova nella libreria denominata MYLIB. 


FROMLIBR SAMPLEl,,FILEl,F1,ADD, MYLIB 


Esempio 5 


Questo esempio spiega come salvare su nastro un membro di procedura di libre- 
ria denominato TEST, con un ID di volume di VOL001. La procedura si trova 
nella libreria denominata MYLIB e la bobina nastro è montata sull'unità nastro 1. 
Dopo aver salvato la procedura sul nastro, scaricare if nastro. 


FROMLIBR TEST,PROC,,T1,,VOLOO1 ,MYLIB,, s$UNLOAD 


Esempio 6 


Questo esempio mostra come copiare tutti i membri origine e di procedura in for- 
mato record con lunghezza 80 caratteri, salvando gli attributi membro. 


FROMLIBR ALL,LIBRARY,FILE1,11,999,VOL001,MYLIB,,,80,SVATTR 
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PROCEDURA HELP 


La procedura HELP consente di: 


e Visualizzare il menù dal quale è possibile selezionare opzioni per eseguire una 
funzione desiderata. 


e Immettere ed eseguire procedure. Ecco le procedure che è possibile eseguire 
usando HELP: 


— Le procedure SSP (ad esempio LISTLIBR o CATALOG). 

— Le procedure che fanno parte del programma di utilità su licenza. Que- 
sto comprende DFU, SDA, SEU e WSU, 

— Le procedure che eseguono programmi di linguaggio su licenza. Questi 
comprendono Assembler, BASIC, COBOL, FORTRAN e RPG. 

— Procedure di comunicazioni dati (ad esempio MSRJE o DEFINEPN). 

— Procedure di sussidio e di servizio (ad esempio APAR o DUMP). 


e Immettere comandi di controllo {ad esempio STATUS o CHANGE). 


e Visualizzare informazioni per molte funzioni del Sistema/36. HELP può esse- 
re usato per visualizzare informazioni di riferimento rapido circa: 


— HH modo in cui usare il supporto di testi esplicativi 
— Specifiche OCL 
— Espressioni di controllo procedura. 


Il menù principale esplicativo viene visualizzato quando un nuovo operatore si 
collega al sistema (senza aver specificato un menù all'atto del collegamento). E’ 
inoltre possibile avviare il supporto di testi esplicativi immettendo la procedura 
HELP sulla tastiera o premendo il tasto di comando 5 su qualsiasi schermo di 
menù o su uno schermo di comandi. E' inoltre possibile immettere il nome del- 
la procedura e premere il tasto Rich Aiuto. Ciò provoca la comparsa di uno 
schermo di richiesta che consente di introdurre dei parametri, 


II supporto di testi esplicativi è costituito da menù che sono organizzati per fun- 
zione che si vuole eseguire. Per esempio, se si vuole creare una nuova libreria, oc- 
corre scegliere un'opzione per lavorare con le librerie e di conseguenza compare 
una seria di menù che fanno riferimento alle librerie. E’ possibile quindi proce- 
dere attraverso i menù fino a che non viene visualizzata la procedura o il coman- 
do che esegue la funzione. 


Quando viene usata la procedura HELP per specificare ì parametri per una pròce- 
dura di sistema e nella libreria corrente dell'utente esiste una procedura deli’uten- 
te con lo stesso nome, verrà presentato lo schermo esplicativo della procedura di 
sistema ma verrà in ogni caso eseguita la procedura dell'utente. Ciò fa sì che la 
procedura dell'utente usi i parametri della procedura di sistema. Se i parametri 
non corrispondono, la procedura dell'utente non viene eseguita correttamente. 


Mentre sono presentati i testi esplicativi, possono essere usati i seguenti tasti di 
funzione e di comando. Il termine ‘tasto di comando significa che si deve premere 
il tasto Cmd e quindi uno dei tasti nella fila superiore della tastiera. Per esempio, 
per premere il tasto di comando 3, occorre per prima cosa premere il tasto Cmd 
e quindi il tasto 3 nella fila superiore; per premere il tasto di comando 15, occor- 
re per prima cosa premere il tasto Cmd e quindi tenere abbassato il tasto Caratte- 


Le | 


bili mascherine per aiutare ad identificare i tasti di comando sulle unità video 
IBM. Vedere la Premessa per ulteriori informazioni sulle mascherine. 








| ri superiori mentre si preme il tasto 3 nella fila superiore. Sono disponi- 


Tasto 


Rich. aiuto 


Tasto di comando 2 


Tasto di comando 3 


Tasto di comando 4 


Tasto di comando 5 


Tasto di comando 6 


Tasto di comando 7 


Funzione 


Visualizza un menù esplicativo o uno schermo di richiesta 
in quanto si è battuto il nome di un menù esplicativo, 
procedura o comando di controllo. Il tasto Rich. aiuto vi- 
sualizza inoltre ulteriori informazioni o testo esplicativo 
relative allo schermo o al menù che sì sta correntemente 
osservando, 


Per le richieste di procedura che hanno bisogno di più di 
uno schermo, il tasto di comando 2 consente di ripresen- 
tare lo schermo delle richieste di procedura precedente 
(per esempio per modificare un parametro immesso scor- 
rettamente). 


Può essere usato in qualsiasi momento per visualizzare il 
precedente menù esplicativo o il menù dell'utente, E’ pos- 
sibile premere il tasto di comando 3 e tornare indietro al 
massimo di 20 menù o schermi (massimo di 10 menù epli- 
cativi; massimo di 10 menù dell'utente). 


Può essere usato soltanto quando viene visualizzata una 
richiesta di procedura. Premendo il tasto di comando 4 si 
inserisce la procedura nella coda lavori invece di eseguirla 
dall'unità video. Deve essere attiva la funzione coda lavori. 


Visualizza il menù esplicativo principale (denominato 
MAIN). 


Visualizza il menù esplicativo iniziale. E' possibile usare 
questo tasto per visualizzare un menù esplicativo che si 
usa spesso, ad esempio il menù di programmazione RPG. 
Per definire un menù da visualizzare quando si preme il 
tasto di comando 6, vedere la descrizione del tasto di co- 
mando 24, 


Può essere usato in qualsiasi momento per terminare la 
presentazione di schermi esplicativi e ritornare allo scher- 
mo che si stava osservando quando si è iniziata la richie- 
sta di testi esplicativi. 


Quando viene presentata una richiesta di comando di con- 
trollo 0 di procedura, il tasto di comando 7 ripresenta lo 
schermo che si stava osservando prima che fosse presenta- 
to lo schermo delle richieste. Potrebbe trattarsi di un me- 
nù esplicativo, del proprio menù, di uno schermo di co- 
mandi vuoto o dello schermo di console (sulla console di 
sistema o su una sottoconsole). 


Quando compare un menù esplicativo, il tasto di comando 
7 ripresenta lo schermo che si stava osservando prima che 
fosse presentato il menù esplicativo. Potrebbe trattarsi del 
menù, di uno schermo di comandi vuoto o dello schermo 
di console. 


Quando viene presentata la parte apprendimento dei testi 
esplicativi, il tasto di comando 7 ripresenta il menù che si 
stava osservando prima di avviare la parte apprendimento. 
Potrebbe trattarsi di un menù esplicativo, del menù sul 
quale sì stava lavorando o dello schermo di comandi 
vuoto oppure dello schermo di console. 
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Tasto 


Tasto di comando 11 


Tasto di comando 12 


Tasto di comando 14 


Tasto di comando 23 


Tasto di comando 24 


Rit. curs. 


Scorrimento in alto 


{ é 


Scorrimento in basso 


{8 


) 


) 


Funzione 


Può essere usato quando viene visualizzato un menù espli- 
cativo per far sì che alla destra dello schermo compaia 
il nome del menù o i nomi dei comandi. 


Può essere usato per avviare l'apprendimento dei testi 
esplicativi quanto viene visualizzato in menù. La parte ap- 


prendimento spiega come è possibile usare il supporto 
esplicativo di sistema. 


Può essere usato su uno schermo di richiesta di procedura 
per far comparire un secondo schermo di parametri da ri- 
chiedere. 


Può essere usato per modificare il menù dell'utente assun- 
to per difetto che viene visualizzato quando ci si collega 
al sistema. Questo menù viene presentato se non si è im- 
messo un nome di menù come parte del processo di col- 
legamento, | nomi del menù e della libreria corrente sono 
salvati nel file di identificazione dell'utente. Il tasto di co- 
mando 23 può essere usato soltanto quando viene visualiz- 
zato un menù dell'utente (non un menù esplicativo). 


Deve essere definito il file di identificazione dell'utente 
perché questo tasto possa funzionare. Per informazioni sul 
modo in cui definire il file di identificazione dell'utente, 
vedere ii manuale Gu/ida alla Riservatezza del Sistema. 


Può essere usato per modificare il menù esplicativo che 
viene visualizzato quando si avvia il supporto dei testi 
esplicativi. Questo menù diventa quindi il menù esplicati- 
vo iniziale. Questo menù viene visualizzato quando si pre- 
me il tasto di comando 6 oppure quando si immette la 
procedura HELP senza parametri. | nomi dei menù espli- 
cativo e della libreria corrente sono salvati nel file di iden- 
tificazione dell'utente. ll tasto di comando 24 può essere 
usato soltanto quando viene visualizzato un menù espli- 
cativo. 


Perché questo tasto possa funzionare, deve essere definito 


‘il file di identificazione dell'utente. Per informazioni sul 


modo in cui definire il file di identificazione dell'utente, 
vedere il manuale Guida alla Riservatezza del Sistema, 


Visualizza il menù dell'utente immesso all'atto del collega- 
mento sul sistema oppure (se non si è immesso un nome 
di menù), il menù di collegamento assunto per difetto. 
Per definire un menù di collegamento, vedere la descrizio- 
ne del tasto di comando 23. 


Mostra lo schermo esplicativo successivo quando viene 
usata una serie di schermi esplicativi per spiegare un argo- 
mento {per esempio il testo esplicativo che illustra i para- 
metri per una procedura o un comando). 


Mostra lo schermo esplicativo precedente in una serie di 
schermi esplicativi. 


La procedura HELP esegue il programma di utilità $HELP. 


nome procedura |.paramì sparam2,.. | 


nome comando [.parami sparam2,.. al 


nome menù testi esplicativi 


MENUNAME 
COMMAND 
OCL 

PCE 





Se non vengono specificati i parametri, viene visualizzato il menù esplicativo ini- 
ziale. Se non c'è un menù esplicativo iniziale, viene visualizzato il menù esplicati- 
vo principale (denominato MAIN). 


nome procedura indica la procedura di cui vengono richiesti i parametri. La pro- 
cedura HELP non supporta il parametro di libreria indicato nella specifica 
OCL INCLUDE. Fare riferimento alla Specifica OCL INCLUDE per informa- 
zioni sul parametro di libreria per un comando di procedura. 


nome comando specifica il comando di controllo da elaborare. 


param1, param2,... rappresenta i parametri per la procedura o il comando di con- 
trollo che lo schermo esplicativo posizionerà sugli schermi di richiesta. E’ 
possibile immettere uno o più spazi in bianco o una virgola tra il nome della 
procedura o il nome del comando di controllo e il primo parametro. Per 
esempio, è possibile immettere uno o l’altro di quanto segue con io stesso 
effetto: ; 


HELP BIDLIBR MYLIB 


oppure: 


HELP BLIDLIBR,MYLIB 
Si potrebbe inoltre battere: 
BLDLIBR MYLIB 
e premere il tasto Rich. Aiuto. 


Tutto ciò fa sì che venga presentato lo schermo delle richieste della proce- 
dura BLDLIBR. Il primo parametro sullo schermo sarà MYLIB. 


nome menù testi esplicativi specifica uno dei menù esplicativi di sistema. Se non 

viene specificato alcun nome, viene visualizzato il menù esplicativo iniziale. 

Se non viene definito alcun menù esplicativo iniziale, viene visualizzato il 

menù esplicativo principale di sistema. (denominato MAIN). E’ possibile usare 

‘ la procedura HELP MENUNAME per visualizzare i nomi dei menù esplicativi 
di sistema. 


MENUNAME provoca la comparsa di una lista dei nomi dei menù esplicativi di 
sistema. 
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COMMAND provoca la visualizzazione di una lista di procedure e di comandi di 
controllo forniti dalla IBM. 


OCL specifica che deve essere visualizzata una lista di specifiche OCL del Sistema/ 
36. Da quella lista è possibile selezionare una specifica per la quale verranno 
visualizzate informazioni di riferimento. 


PCE specifica che deve essere visualizzata una lista di espressioni di controllo pro- 
cedura del Sistema/36. Da quella lista è possibile selezionare le espressioni 
per le quali verranno visualizzate informazioni di riferimento. 


Esempio 1 


Si desidera creare una nuova libreria ma non si conosce il nome della procedura 
che crea una libreria. Quando si immette HELP, compare lo schermo che segue: 


MAIN 
SISTEMA/36 - Menù principale di ausilio 
Scegliere una delle opzioni: 


«+ Visualizzazione menù utente 

. Esecuzione attività generali del sistema 

. Uso e controllo stampatrici, minidischi o nastro 

. Uso e gestione librerie o file di dati 

. Uso linguaggi di programmazione e programmi di utilità 
. Comunicazioni con altri sistemi o utenti 

. Definizione del sistema e dei relativi utenti 

+. Diagnostica e manutenzione 

. Utilizzo prodotti per ufficio 

+ Scollegamento del sistema 


1 
2 
3 
4 
5 
6 
7 
a 
9 
10 


CMD3-Menù precedente CMD7-Fine CMD12-Inform.ausilio Rit.cursore-Menù colleg. 


Immettere numero opzione 0 comando 


F i 
(c) 1983 IBM Corp. 





Figura 11. Schermo menù esplicativo principale 
Poiché si desidera creare una libreria, si sceglie l'opzione 4: 


lì. Uso e gestione librerie o file di dati 


Dopo aver battuto 4 e aver premuto il tasto Entr/Avanz Rec. compare il se- 
guente menù: 


LIBRFILE 


Uso e gestione delle librerie o dei file di dati 


Scegliere una delle opzioni: 


1. Uso e gestione delle librerie 

2, Uso e gestione dei file di dati 

3. Uso e gestione delle cartelle 
4. Uso e gestione dei file remoti 


CMD3-Menù precedente CMD7-Fine CMD5-Menù ausilio prince. Rit.cur-Menù coll. 
Immettere numero opzione o comando 


dle "9 
(c) 1983 IRM Corp. 





Figura 12. Menù manutenzione file di dati o libreria 


Qui occorrerebbe prendere l'opzione 1 in quanto si desidera creare una libreria. 
Dopo aver immesso 1, compare il seguente menù: 


LIBRARY 
Uso e gestione librerie 
Scegliere una delle opzioni: 


+ Creazione di una libreria 
. Copia, salvataggio o ripristino di libreria/membri di libreria 
3. Lista informazioni sulla libreria 
. Cancellazione di una libreria o di membri di libreria 
. Compressione di membri per rilasciare spazio in libreria 
Ridenominazione della libreria 
Creazione o modifica dei membri di libreria 
Modifica ampiezza libreria o relativo indirizzario 


CMD3-Menù precedente CMD7-Fine CMD5-Menî ausilio prince. Rit.cur-Meni coll. 
Immettere numero opzione o comando 
1 


{c) 1983 IBM Corp. 





Figura 13. Menù di lavoro con librerie 
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Qui occorrerebbe scegliere l'opzione 1 in quanto si desidera creare una libreria. 
Dopo aver immesso 1, compare lo schermo che segue: 


PROCEDURA BLDLIBR Facoltat.-* 
Creazione di una nuova libreria con opzione di copia membri nella libreria 
Nome della libreria da creare 
Ampiezza della libreria in blocchi 


Ampiezza dell'indirizzario in settori . . . .. 


Posizione su disco preferita . . ... +. . Al,A2,numero blocco 


Per copiare un file nella libreria, immettere il nome del file 


CMD3-Menù precedente 
(c) 1983 IBM Corp. 





Figura 14. Schermo della procedura BLDLIBR 


Qui occorrerebbe immettere il nome della libreria e la dimensione detla libreria. 
Questo esempio mostra che l'operatore ha immesso un nome di libreria MYLIB 
e la dimensione di libreria deve essere di 100 blocchi. Non è stato immesso alcun 
parametro per la locazione preferita del disco. Inoltre, poiché non è stato immes- 
so alcun nome file, la libreria è nuova e non ha membri. 
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Esempio 2 


Si supponga di voler creare una libreria e di sapere che la procedura BLDLIBR 
crea librerie ma non si sa quali parametri richiede la libreria BLDLIBR. E' possi- 
bile immettere quanto segue per far sì che compaia lo schermo delle richieste 
della procedura BLDLIBR e quindi inserire i parametri adatti: 


HELP BLIDLIBR 


Si potrebbe inoltre immettere quanto segue: 
BLDLIBR 


e premere il tasto Rich Aiuto. 


Esempio 3 


Si supponga di voler creare una libreria denominata MYLIB e di sapere che: 
e La procedura BLDLIBR crea delle librerie. 
e Il primo parametro della procedura BLDLIBR è il nome della libreria. 
Non si conoscono invece gli altri parametri. 
E’ possibile immettere quanto segue per far sì che compaia lo schermo delle ri- 
chieste BLDLIBR con il nome delia libreria inserito e quindi poter inserire gli 
altri parametri. 
HELP BLDLIBR MYLIB 
oppure 
HELP BLDLIBR,MYLIB 
Sarebbe inoltre possibile immettere: 


BIDLIBR MYLIB 


e premere il tasto Rich Aiuto. 


PROCEDURA HISTCRT 
La procedura HISTCRT è supportata soltanto per compatibilità con il Sistema/34 


della IBM. Vedere la Procedura HISTORY per informazioni sul modo in cui vi- 
sualizzare le entrate del file storico, cronologico. 
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Il file storico, cronologico viene auto- 
maticamente copiato in un file resi- 
dente denominato HISTCOPY 





PROCEDURA HISTCOPY 


La procedura HISTCOPY viene eseguita dopo che il file storico, cronologico è 
stato automaticamente copiato su un file su disco denominato HISTCOPY. Quan- 
do viene installato per la prima volta il SSP, la procedura HISTCOPY contiene 
soltanto commenti. E’ possibile modificate o cambiare la procedura HISTCOPY 
per eseguire un proprio lavoro dopo che il file storico, cronologico è stato copia- 
to. Non possono essere passati parametri nella procedura. Vedere la Procedura 
HISTORY per ulteriori informazioni sui processo di copia automatica del file sto- 
rico, cronologico, 


Per creare proprie procedure, vedere il Capitolo 2, Creazione di proprie procedu- 
re. Occorre inserire la procedura HISTCOPY nella libreria di sistema (#LIBRARY). 


Quanto segue mostra la relazione tra il processo di copia automatica del file sto- 
rico, cronologico e la procedura HISTCOPY: 






It file storico, cronologico 
si riempie per 180% 












Inizia l'esecuzione della 
procedura HISTCOPY 






Figura 15. Relazione tra HISTCOPY e file storico, cronologico 


Considerazioni per la riservatezza mediante parola d'ordine 


x 


Quando è attiva la riservatezza mediante parola d'ordine, \'ID dell'utente dell’o- 
peratore che ha provocato il riempimento all’'80% del file storico cronologico è 
usato dal sistema per controllare la classificazione di riservatezza dei lavori ese- 
guiti dalla procedura HISTCOPY. 


Per esempio, c'è una procedura contenuta nella procedura HISTCOPY che può 
essere eseguita soltanto da un operatore di sistema. Se un lavoro eseguito da un 
operatore all'unità video fa sì che venga avviata la procedura HISTCOPY, viene 
trasmesso un messaggio di errore (alla console di sistema) quando viene effettua- 
to il controllo di riservatezza per la procedura. Ciò in quanto l'operatore dell'uni- 
tà video ha una classificazione di riservatezza inferiore rispetto all'operatore di 
sistema. 


Pertanto, quando è attiva fa riservatezza con parola d'ordine, non si devono inciu- 
dere le procedure nella procedura HISTCOPY limitate a taluni operatori. 


Esempio 


Questo esempio mostra le procedure che è possibile includere nella procedura 
HISTCOPY che si possono quindi memorizzare nella libreria di sistema (#LIBRA- 


RY). 

* HISTCOPY PROCEDURA 

* Questa procedura crea il file HIST.O1, HIST.02, HIST.03 

* Il nome di ciascuna procedura è controllato fino a quando è 
trovato un nome non usato. 

* 


* 
* 


Il file HISTCOPY assume come nuovo nome quello del file non 
usato. 


Il parametro 1 è usato come un contatore. 


// EVALUATE P1=0 
* 


* 
* 


Controllo dell'esistenza dei file HIST.nn 


// TAG LOOP 
// EVALUATE P1,2=21?+1 
// IF DATAF1-HIST.?1?  GOTO LOOP 


* 


* Il file HIST.nn non esiste, ridenominazipne di HISTCOPY in HIST.nn 


* 


RENAME HISTCOPY,HIST.?1? 
* 


* 
* 


Invio di un messaggio all'operatore di Sistema 


// MSGF ,File HISTCOPY è stato copiato nel file HIST.?1? il ?DATE? 


alla ?TIME? 
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PROCEDURA HISTORY 


La procedura HISTORY consente di: 


© 
° 


Ne 


Visualizzare o stampare tutto 0 bare del file storico, cronologico 
Copiare il file storico, cronologico su un file su disco per uso successivo 
Cancellare il file storico, cronologico 

file storico, cronologico sono registrate le seguenti informazioni: 


Tutte fe procedure, comandi di controllo e specifiche OCL e specifiche di 
controllo di programmi di utilità elaborati dal SSP. Le specifiche OCL e le 
specifiche di controllo di programmi di utilità saranno registrate soltanto 
quando è attivata la registrazione. Vedere la Procedura LOG o la Specifica 
OCL LOG per informazioni sull'attivazione della registrazione. 


Inoltre, quando è attivata la registrazione, le opzioni di menù scelte dall’u- 
tente e i menù esplicativi sono a loro volta registrati nel file cronologico. 


Tutti i messaggi visualizzati sulle unità video. | messaggi che sono visualiz- 
zati sulla console di sistema o sottoconsole, ricevono un ID a 4 cifre e ven- 
gono registrati sul file storico, cronologico (l'ID a 4 cifre e il messaggio sono 
registrati). Quando l'operatore risponde al messaggio, che può arrivare qual- 
che tempo più tardi, vengono registrati l'ID a 4 cifre e le risposte al messag- 
gio ‘REPLY command successful’. Usando l'ID a 4 cifre è possibile combi- 
nare i messaggi alle rispettive risposte. Gli ID a 4 cifre sono usati soltanto 
per il file storico, cronologico e non sono visualizzati con il Messaggio. 


Tutte le risposte ai messaggi da parte dell’operatore. 
Entrate di fine lavoro e di fine stampa lavori. 


L'ID dell'utente dell'operatore associato con l’entrata. Se l’entrata viene da 
un lavoro nella coda lavori, all'entrata non è associato alcun ID dell'utente, 


L'ID dello schermo o l'ID della stampante associati con l’entrata. Se l’en- 


trata proviene da un lavoro nella coda dei lavori, a quell’entrata non è asso- 
ciato alcun ID di unità video. 


x 


li nome del lavoro associato con l’entrata, Se l’entrata è un comando di 
controllo, all'entrata non viene associato alcun nome di lavoro. 


L'ora in cui l’entrata è stata inserita nel file storico, cronologico. (L'ora è 
basata su quella specificata dall'operatore di sistema durante l’IPL). 


La data (data del sistema) quando l’entrata è stata inserita nel file storico, 
cronologico. (La data è basata su quella specificata dall'operatore durante 
VIPL). 


Poiché il file cronologico ha un'ampiezza limitata (la dimensione specificata du- 
rante la configurazione del sistema), il numero di eventi che può essere riflesso 
nel file cronologico in un momento particolare varia in relazione alla lunghezza. 
del file ed alla dimensione delle entrate nel file stesso. Inoltre, il file cronologico 
varia in continuazione. Pertanto, una richiesta di listare o osservare le entrate po- 
trebbe non presentare tutte le entrate richieste. In questo caso occorre eseguire 
di nuovo la procedura, 


HISTORY 


HISTORY 


HISTORY 





Per evitare di perdere entrate di file storico, cronologico dopo aver riempito il 
file storico, cronologico stesso, è possibile richiedere che quando il file storico, 
cronologico è pieno per l’80% venga copiato su un file su disco denominato 
HISTCOPY. E’ possibile specificare questa opzione durante ia configurazione del 
sistema; vedere il manuale Modifica della configurazione del sistema per ulteriori 
informazioni. Ciò può far sì che un lavoro venga eseguito dopo l'esecuzione della 
copia; vedere la Procedura HISTCOPY per ulteriori informazioni. La procedura 
HISTORY esegue il programma di utilità $HIST. 


Per stampare o visualizzare le entrate di file storico, cronologico: 


LIST|, |USER , ALLWS , ;ALLENTS ; 
CRT ia utente| |ia terminale video| |nome procedura 
ALL EONLY 


ALLDAYS|,|ora d'inizio|,|ora di fine|,|SYSTEM , INOERASE 
TODAY 000000 235959 nome file ERASE 
data Ji 





Per copiare le entrate di file storico, cronologico su un file su disco: 


COPYSYS|, |USER , | ALLWS , |ALLENTS î 
COPYPRT { {id utente id terminale video| |nome procedura 
ALL EONLY 


ALLDAYS|,|ora d'inizio], |ora di fine|,|HF id terminale video|, [NOERASE 
TODAY 000000 235959 nome file ERASE 


data 








Per cancellare le entrate di file storico, cronologico: 


ERASE,| USER , /ALLWS , ;ALLENTS 
id utente id terminale video nome procedura 
ALL EONLY 





ALLDAYS |,|ora d'inizio|, Jora di fine 
TODAY 000000 235959 
data Ù 
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Se si immette la procedura HISTORY senza parametri, viene presentato uno 
‘schermo di richieste per consentire l'immissione dei parametri. 


LIST specifica che le entrate di file storico, cronologico devono essere listate sul- 


l'unità di lista del sistema che può essere una stampatrice o un'unità video. 
Per determinare l'unità di lista. del sistema, immettere il comando STATUS 
SESSION. Per modificare l’unità di lista del sistema, vedere la Procedura 
SYSLIST o la Procedura PRINT. 


Vedere la Lista campione HISTORY per una descrizione della lista che viene 
stampata. 


CRT specifica che devono essere visualizzate le entrate di file storico, cronologico. 


E' possibile: 
e Scorrere in avanti e all'indietro ie entrate del file storico, cronologico 


per l’unità video o (se il livello di riservatezza lo ammette) esaminare 
tutte le entrate nel file storico, cronologico. 


e Cercare nel file storico, cronologico le entrate contenenti dati specifici 
ad esempio una stringa di caratteri, un ID di terminale, un ID di utente, 
un nome di lavoro, un'ora di inizio o di fine e una data. 


e Modificare la quantità di informazioni di controllo visualizzate. 


e Modificare le informazioni usate per selezionare quali entrate verranno 
visualizzate. 


® Visualizzare (se il livello di riservatezza lo ammette) tutte le entrate di 
file storico, cronologico man mano che vengono aggiunte al file storico, 
cronologico stesso, 


Nota: Quando si usa il parametro CRT, le entrate che superano i 76 carat- 
teri (ad esempio le entrate *EP) vengono troncate. 


Se è attiva la riservatezza mediante parola d'ordine occorre avere una classi- 
ficazione di riservatezza di operatori di sistema o più elevata per poter osser- 
vare le entrate per un altro operatore. 


Vedere lo Schermo campione HISTORY per una descrizione degli schermi 
presentati per le informazioni sul modo in cui usare questa opzione. 


COPYSYS specifica che le entrate di file storico, cronologico devono essere co- 


piate su un nuovo file su disco. Il formato del file su disco è nel formato di 
sistema e cioè lo stesso formato del file storico, cronologico di sistema. Ciò 
consente di usare il file successivamente per stampare o visualizzare le entrate 
oppure per salvare le entrate su minidisco. 


COPYPRT specifica che le entrate di file storico, cronologico devono essere 


copiate su un nuovo file su disco. II formato del file su disco è quello 
Che si avrebbe se il file venisse copiato o stampato (mediante la procedura 
COPYPRT) su un file su disco. Vedere la Procedura COPYPRT per il forma- 
to di record in questo file. Ciò consente di usare il file come immissione per 
un altro programma. ll file può anche essere usato come immissione alla pro- 
cedura COPYPRT per visualizzare o stampare le entrate. 


ERASE (nella prima posizione di parametro) specifica che le entrate di file 


storico, cronologico devono essere cancellate. 


USER specifica che le entrate di file storico, cronologico che corrispondono al- 


"ID dell'utente e dell'operatore devono essere elaborate. Se non è specifi- 
cato alcun parametro, si presume USER. 


RTS 


id utente specifica un ID di utente dell'operatore. Devono essere elaborate solo 
le entrate che corrispondono all’1D di utente specificato. 


Se è attiva la riservatezza mediante parola d‘ordine, l'operatore che esegue la 
procedura HISTORY deve essere classificato come operatore di sistema o 
avere una classificazione più elevata per poter elaborare le entrate di un altro 
operatore. 


ALL specifica che tutte le entrate degli ID degli utenti devono essere elaborate. 


Se è attiva la riservatezza mediante parola d'ordine, l'operatore che esegue la 
procedura HISTORY deve essere classificato come operatore di sistema o 
avere una ciassificazione più elevata per elaborare le entrate di un altro ope- 
ratore. 


ALLWS specifica che le entrate di file storico, cronologico relative a tutte le uni- 
tà video devono essere elaborate. Se non viene specificato alcun parametro, 
si presume ALLWS. 


id terminale video specifica l'ID del terminale di un'unità video. Vengono elabo- 
rate soltanto le entrate che corrispondono all’ID dell'unità video specificata. 


ALLENTS specifica che devono essere elaborate tutte le entrate nel file storico, 
cronologico. Se non è specificato alcun parametro, si presume ALLENTS. 


nome. procedura specifica che devono essere elaborate soltanto le entrate associa- 
te con il nome di procedura specificato. 


EONLY specifica che devono essere elaborate soltanto le entrate che iniziano con 
“E. *EJ indica entrate di fine lavoro; *EP indica entrate di fine stampa. Ciò 
fornisce un sommario della data di inizio e di fine dei lavori unitamente con 
le unità video dalle quali i lavori sono stati eseguiti e gli operatori che hanno 
eseguito quei lavori. 


ALLDAYS specifica che le entrate devono essere elaborate indipendentemente 
dalla loro data. Se non è specificato alcun parametro, si presume ALLDAYS, 


TODAY specifica che devono essere elaborate soltanto le entrate con la data 
odierna del sistema. 


data specifica una data. Devono essere elaborate soltanto quelle entrate che corri- 
spondono alla data specificata. La data deve essere immessa nel formato deli 
sistema; ossia nella forma mmggaa {mese,giorno,anno), ggmmaa (giorno,me- 
se,anno) o aammgg (anno,mese,giorno). Usare il comando STATUS SESSION 
per determinare il formato della data di sistema. 


ora di inizio indica un'ora di inizio. Devono essere elaborate soltanto le entrate 
che si verificano in corrispondenza o dopo l'ora specificata. L'ora deve esse- 
re immessa nel formato HHMMSS (ore,minuti,secondi). Per esempio: 


8:32:53 AM viene immesso come 083253 
1:12:00 PM viene immesso come 131500 


E' possibile specificare qualsiasi numero a 6 cifre da 000000 a 235959. Se 
non è specificato alcun parametro, si presume 000000. 


ora di fine specifica l'ora di fine. Devono essere elaborate soltanto le entrate che 
si verificano in corrispondenza o prima dell'ora specificata. L'ora deve essere 
immessa nel formato HHMMSS (ore,minuti,secondi). E’ possibile specificare 
qualsiasi numero a 6 cifre da 000000 a 235959. Se non viene specificato al- 
cun parametro, si presume 235959. 
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SYSTEM specifica che il file storico, cronologico di sistema deve essere visualiz- 
zato o stampato. Se non è specificato alcun parametro, si presume SYSTEM. 


nome file specifica quanto segue: - 


Se è specificato LIST o CRT, il nome file indica il file su disco da stam- 
pare o visualizzare. ll file deve essere stato creato usando il parametro 
COPYSYS della procedura HISTORY oppure dalla funzione di copia au- 
tomatica del file storico, cronologico. Per ulteriori informazioni sulla 
funzione di copia automatica del file storico, cronologico, vedere la Pro- 
cedura HISTCOPY a pag. 000. 


ERASE non può essere specificato se viene specificato un nome file di- 
verso da SYSTEM. 


Se viene specificato COPYSYS o COPYPRT, il nome file specifica il file 
su disco da creare. Questo file su disco conterrà le entrate elaborate del 
file storico, cronologico. 


Se non viene specificato alcun nome file e viene specificato COPYSYS o 
COPYPRT, il nome assegnato al file è costituito dalle letter HF e dal- 
l'ID dell'unità video. Per esempio, se l'ID dell'unità video fosse W3, il 
nome del file sarebbe HFW3. 


NOERASE specifica che le entrate elaborate non devono essere cancellate. Se 
non viene specificato alcun parametro, si presume NOERASE. 


ERASE specifica che le entrate elaborate devono essere cancellate dopo essere 
state elaborate. 


Votes 


Esempio 1 


Per visualizzare entrate di file storico, cronologico, l'operatore dovrebbe immet- 
tere: 


HISTORY CRT 


Esempio 2 


Per listare l’intero file storico, cronologico di sistema e cancellare tutte le entrate 
nel file storico, cronologico, l'operatore dovrebbe immettere: 


HISTORY LIST,ALL,,,,3,ERASE 


Esempio 3 


Per listare tutte le entrate di file storico, cronologico che sono state create come 


risultato dell'esecuzione da parte dell'operatore di lavori su un’unità video, l'ope- 


ratore dovrebbe immettere: 


HISTORY LIST 


Esempio 4 


Per listare le entrate di file storico, cronologico associate con l'esecuzione di una 
procedura denominata TEST, l'operatore dovrebbe immettere: 


HISTORY LIST,,,TEST 


Esempio 5 


Per copiare le entrate di fine. lavoro della giornata su un file su disco (nel forma- 
to COPYPRT), denominato LISTFILE, l'operatore di sistema dovrebbe immette- 
re: 


HISTORY COPYPRT,,,FONLY,TODAY,, ,HISTFILE 
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Schermo campione HISTORY 


Quando viene eseguito HISTORY CRT, compare lo schermo in Figura 16 (que- 
sto schermo è presentato con alcune informazioni campione): 


SCORR, FILE STORICO TERMIN. UTENTE NOME LAVORO ORA 
CATALOG wW_N W1135818 13.58.18 
Procedura CATALOG in esecuzione wl N Wl1358165 13.58.49 
W. N W1135848 13.58.52 
SYS-8423 SRT annullato con opzione interrogazione 3 da WI 
W N Ww1135848 13.58.52 
*EJ 13.58.18 13.58.52 00.00.04 08/07/83 N WI CATALOG 
HELP CATALOG W1135855 13.58.56 


Wl 
CATALOG ALL,I1,M2.01,M1.01,LOCATION W W1135855 13.59.08 

wl W1135855 13.59.09 
wl - W1135855 13.59.19 
*EJ 13,58.55 13.59.19 00,00.24 08/07/83 N HELP 


Procedura CATALOG in esecuzione 


HELP LIBRFILE WI KRKRKKK*  ]h,00.30 
HELP LIBRARY WI RISAIE 1U,00,39 
HELP BLDLIBR W W1130103 14.01.03 
WI Wl1140103 14.01.37 
*EJ 14.01.03 14.01.37 00.00.34 08/07/83 N WI HELP 

HELP HISTORY WlL N wilko142 14.01.33 
Wl N wilbolba 14.01.49 

HISTORY CRT,USER,ALLWS,ALLENTS,ALLDAYS,000000,235959,SYSTEM,NOERASE 
Procedura HISTORY CRT in esecuzione WI N wilbolk2 134,01.51 

NESSUN ELEMENTO AGGIUNTIVO NEL FILE STORICO 

CMD7-Fine lavoro CMD8-Visualizz.meno ‘recente CMD9-Visualizz.più rec 

Direzione- B Dati scans.- Video- Uten.- N 





Figura 16. Schermo campione HISTCRT 


Sono visualizzate per prime le entrate più recenti nel file storico, cronologico per 
l'ID dell'utente dell'unità video richiedente. 
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Alla base dello schermo passono essere immessi i valori di scansione. Se si immet- 
te uno o più valori alla base di questo schermo, il sistema cerca nel file storico, 
cronologico le entrate che corrispondono ai valori di scansione, Dati scans. si ap- 
plica soltanto alla porzione di testo delle entrate di file storico, cronologico. 
Video e Uten. si applicano soltanto alla porzione d'informazioni di controllo del 
le entrate. L'ID del terminale, VID dell'utente, il nome del lavoro e l'ora sono 
considerati informazioni di controllo per lo schermo. E’ possibile specificare i se- 
guenti valori di scansione: 


Direzione Immettere F per una scansione in avanti o B per una scansione al- 
V’indietro. Se non si immette un valore in questo campo, il sistema 
presume una scansione all'indietro (B) nel file storico, cronologico. 


Dati scans. immettere una stringa da 1 a 20 caratteri da cercare nell'ambito del- 
i la porzione specifica delle entrate di file storico, cronologico. Non 
è possibile immettere lettere minuscole. 


Video Immettere un ID di unità video di 2 caratteri. 

Utente Immettere un ID di utente da 1 a 8 caratteri. Se era stato immesso 
un ID di utente diverso da ALL nella procedura HISTORY, questo 
campo sarà già compilato e non sarà possibile cambiarto. 


Quando si preme il tasto Entr/Avanz.Rec. dopo aver immesso un valore nei sud- 
detti campi, il sistema cerca nel file storico, cronologico il valore specificato. Se 
si specifica più di un valore di scansione, devono essere soddisfatte tutte Je con- 
dizioni specificate perché la ricerca riesca. 


Se viene specificato una scansione in avanti (F nel campo di direzione) la ricerca 
inizia con la prima riga correntemente visualizzata. Se la ricerca riesce, i caratteri 
trovati vengono sottolineati ed evidenziati. i 


Per continuare l'operazione di scansione con gli stessi valori, premere il tasto 
Immis. La scansione continuerà iniziando con l’entrata di file storico, cronologico 
che segue l’ultima entrata correntemente visualizzata. Se non si trovano i valori di 
scansione specificati nel file storico, cronologico, viene visualizzato un messaggio. 


Se viene specificata la scansione all'indietro (B nel campo di direzione), la ricerca 
inizia con l’ultima riga sullo schermo e procede all’indietro nel file storico, crono- 
logico. Se la scansione riesce, i caratteri trovati vengono sottolineati ed evidenzia- 
ti. Se si preme il tasto Immis per continuare la scansione, la ricerca riprende ini- 
ziando con l'entrata di file storico, cronologico che viene prima della prima riga 
sullo schermo. Se i valori di scansioni specificati non vengono trovati nel file sto- 
rico, cronologico, viene visualizzato un messaggio. 
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Tasti di comando e di funzione che è possibile usare 


Sono disponibili i seguenti tasti di comando e di funzione sullo schermo di scor- 
rimento del file storico, cronologico presentato in Figura 16. 


Tasto scorrimento in alto ( È) . 
Usato per scorrere in avanti nelle entrate successive o più recenti del file sto- 
rico, cronologico. Quando viene visualizzata l’ultima o la più recente entrata 
nel file storico, cronologico, viene visualizzato un messaggio Last entry. Se 
viene usato il tasto scorrimento in alto ( & ) quando viene presentata l’ulti- 
ma entrata, viene ripresentato lo schermo corrente. 


Tasto scorrimento in basso {( #) 
Usato per scorrere all'indietro per esaminare le precedenti o le più vecchie 
entrate di file storico, cronologico. Quando viene visualizzata la prima o la 
più vecchia entrata nel file storico, cronologico, compare il messaggio First 
entry. Se viene usato il tasto scorrimento in basso ( # ) quando compare la 
prima entrata, viene ripresentato lo schermo corrente. 


Tasto di comando 3 
E’ usato per modificare il fattore di scorrimento dei tasti scorrimento in alto 
{ #) e scorrimento in basso ( #); e cioè il numero delle entrate di file stori- 
co, cronologico da esaminare. 


Per modificare il fattore di scorrimento per il resto della procedura HISTO- 
RY, battere il nuovo numero di entrate da far scorrere nel campo del fat- 
tore di scorrimento e premere il tasto Immis. Le entrate valide per il campo 
del fattore di scorrimento, vanno da 1 a 999. Se non è immesso un valore 
in questo campo, il sistema presume il numero delle entrate indicato su uno 
schermo pieno. 


Per modificare il numero di entrate da far scorrere per una sola operazione 
del tasto di scorrimento, battere il nuovo numero di entrate quindi usare il 
tasto scorrimento in alto { #) o il tasto scorrimento in basso ( # ). Le en- 
trate valide per un campo del fattore di scorrimento vanno da 1 a 999. Se 
non è immesso un valore in questo campo, il sistema assume il numero di 
entrate che compare su uno schermo pieno, | 


Tasto di comando 4 
E’ usato per specificare se si desidera visualizzare le seguenti informazioni 


di controllo per ciascuna entrata nel file storico, cronologico: 

e ID del terminale 

e ID dell'utente 

e Nome lavoro 

e Ora 

Se vengono correntemente visualizzate le informazioni di controllo, usare il 
tasto di comando 4 per far sì che lo schermo non visualizzi queste informa- 
zioni di controllo. Se non sono visualizzate correntemente le informazioni 


di controllo, usare il tasto di comando 4 per far sì che lo schermo visualizzi 
le informazioni di controllo. 


Tasto di comando 5 
E’ usato per specificare se si vogliono visualizzare le entrate non osservate 
sul file storico cronologico. Le entrate osservate sono quelle che sono state 
visualizzate prima di venire registrate sul file storico, cronologico. Le entra- 
te non osservate includono le entrate *E e tutte le specifiche OCL generate 


dalle procedure. 


Se sono correntemente visualizzate le entrate non osservate, usare il tasto di 
comando 5 per far sì che lo schermo non visualizzi le entrate non osservate. 
Se sono correntemente visualizzate soltanto le entrate osservate, usare il ta- 
sto di comando 5 per far sì che lo schermo visualizzi anche le entrate non 


osservate. 


Tasto di comando 6 
Usato per definire quali valori devono essere soddisfatti prima che venga vi- 
sualizzata un'entrata scelta sul file storico, cronologico. Cioè se un'entrata 
di file storico, cronologico non corrisponde alle entrate specificate su questo 
schermo, quelle entrate di file storico, cronologico, non sono presentate. Lo 
schermo che segue compare quando viene premuto il tasto di comando 6: 


VARIAZIONE CRITERIO DI SCELTA Facoltativo-* 


Annullamento o variazione criterio di scelta per schermo di scansione 


ID terminale 

ID utente 

Nome lavoro . . . . 
Tempo di avvio 
Tempo di arresto 


Elemento data 


CMD6-Per annullare la scelta qui sopra e ritornare allo schermo di scansione 
CMD7-Per ritornare allo schermo di scansione senza variare criterio di scelta 





Se si è immesso un ID dell'utente diverso da ALL sulla procedura HISTORY, 
il campo ID dell'utente sarà già compilato e non sarà possibile modificarlo. 
Se nella’ procedura HISTORY si è immesso un ID di unità video o l'ora di 
inizio o lora di fine, oppure una data, questi campi saranno già compilati e 
non sarà possibile modificarli. 
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Tasto di comando 7 
E’ usato per terminare la procedura HISTORY, 


Tasto di comando 8 . 
È’ usato per visualizzare l’entrate di file storico, cronologico più vecchia. 


Tasto di comando 9 
E’ usato per visualizzare l'entrata di file storico, cronologico più recente. 


Tasto di comando 10 

E’ usato per controllare se vengono visualizzate soltanto le entrate di file 
storico, cronologico che iniziano con *EJ (fine lavoro) o *EP (fine stampa). 
Se vengono correntemente visualizzate le entrate *E e altre informazioni di 
file storico, cronologico, il tasto di comando 10 provoca la visualizzazione 
delle sole entrate *E. Se sono visualizzate soltanto le entrate *E, il tasto di 
comando 10 fa sì che vengano visualizzate le entrate *E e le altre informa- 
zioni di file storico, cronologico. 
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Lista campione HISTORY 


La Figura 17 mostra un tabulato campione di un file storico, cronologico. Dopo 


la figura vengono spiegate le varie voci sul tabulato. 


VISUALIZZAZIONE FILE STORICO Terminale video- W2 Utente - SET Data - 12/09/83 Ora - 15.23.22 
HISTORY LIST.,ALL,ALLWS,ALLENTS,ALLDAYS,000000,235959,SYSTEM,NOERASE 


Data primo elem.della pagina - 12/09/83 TERM. 


UTENTE 


Pag. - 23 


NOME LAV. 


*EP 15.02.06 15.02.08 00.00,02 12/08/83 UTENTEAB Pl SEU WI1h5920 0001 NC 
SEU RAALX05,P, s ,ABSTORE 
#SEU,#SEULIB *ALL 
Procedura SEU in esecuzione 
*EJ 15.02,27 15.02.42 00.00.15 12/09/83 UTENTEAB Wh SEU 
SEU $$BALX05,P,, ,ABSTORE 
#5EU,#SEULIB *ALL 
Procedura SFU in esecuzione 
*EJ 15.,02.5% 15.03.16 00.00.22 12/09/83 UTENTEAB Wi SEU 


Elemen.sistema- ** 
*EP 15.03.16 15.03.18 00.00.02 12/09/83 UTENTEAB Pl SEU W4150254 0001 NC 
SEU BALAO1,R,, ABSTORE Wù 
#SEU,#SEULIB *ALL l 
Procedura SEU in esecuzione 
*EJ 15.03.30 15.09.25 00.05.55 12/09/83. UTENTEAB Wh SEU i) 
RPG BALA01,50,50, ,ABSTORE,ABSTORE DA 
//] INCLUDE RPG,#RPGLIB *ALL 
Procedura RPG in esecuzione 
// INCLUDE RPGC,#RPGLIB BAUAO1,ABSTORE,,,NOXREF,,NONEP,ABSTORE,,, sHALT,NOREPLAC,,33350,RPG "' 
SYs-6001 DDXL Wh150948 Console princ. -WI 
File $SOURCE è stato esteso Console princ. -'' 
*#EJ 15.09.48 15.13.15 00,03.57 12/09/83 UTENTEAB Wi RPG Wh 
SET ‘ 


ti 


' 


ì Elemen. sistema-** 

*EP 15,13.45 15.16.59 00.03.05 12/09/83 UTENTEAB Pl RPG wl150948 0001 NC 
SEU $$BALAG1,P,, ABSTORE Wi 
#SEU,#SEULIB *ALL n 
Procedura SEU in esecuzione 
HELP HISTORI w2 
SYS-2001 Opzioni ( 3) HELP 11 
Nome specificato non valido per la procedura HELP 

3 

*EJ 15.21.59 15.22,05 00.00.06 12/09/83 SET W2 HELP Di 
HELP HISTORY " 
*EJ 15.22.12 15.22.2% 00.00.12 12/09/83 SET Wo HELP da 
SYSLIST PI to 
*EJ 15.22.31 15.22.32 00.00.01 12/09/83 SET W2 BYSLIST Da 
HELP. SET n 
SET ,3,33,P1 iù 
Procedura SET in esecuzione . 
*EJ 15.22.35 15.22.36 00.00.11 12/09/83 SET W2 HELP LE 
HELP HISTORY " 
*EJ 15.21.31 15.23.09 00.01.38 12/09/83 UTENTEAB Wk SEU wi 
HISTORY LIST,ALL,ALLWS ALLENTS ,ALLDAYS ,000000,235959,SYSTEM,NOERASE wa 
Procedura HISTORY in esecuzione to 
SEU $$BALKAX30,P,,,ABSTORE î Wù 
#SEU,#SEULIB *ALL DL 
Procedura SEU in esecuzione no 
SEU-0626 Opzioni ( 3) SE a 
Nome membro non valido, troppo lungo, ALL, NEW, DIR o SYSTEM SI 


URI 


CAL) 
tr 


ti 


3 
*EJ 15.23.27 15.23.37 00.00.10 12/09/83 UTENTEAB Wh SEU Wh 


Visualizzato numero delle voci - 1132 


Figura 17. Lista campione del file storico cronologico 
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15.02.27 
15.02.28 
15,02. 29 
15,02, k2 
15.02,5h 
15,02. 55 
15.02.56 
15.03.16 
15.03.18 
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25.03.31 
15.03, 32 
15.09. 6 
15.09.48 
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15.22.00 
15.22.00 
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15,22,06 
15.22.12 
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15.20.35 
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15.23.36 
15.23.37 


301 


302 


Descrizione delle varie voci sulla lista del file storico, cronologico 


Informazioni di testata 


TERMINALE: indica l'unità video dalla quale è stata eseguita la procedura 
HISTORY. 


UTENTE: indica chi ha eseguito la procedura HISTORY (I"ID dell'utente). 
ORA: indica l'ora in cui è stata eseguita la procedura HISTORY. 


DATA: indica la data in cui è stata eseguita la procedura HISTORY. 


Corpo del prospetto 
Specifica: indica le procedure, i comandi, le specifiche OCL e i messaggi scritti 
sul file storico, cronologico. Le specifiche sono rientrate sulla lista come se- 


gue: 


Posizione Testo file storico, cronologico 


1 Tutte le entrate che iniziano con *E, 


3 Qualsiasi entrata che era visualizzata prima di venire registrata 
sul file storico, cronologico. 


7 Tutte le specifiche OCL eseguite durante una procedura. 
5 Tutte le altre entrate. 

Le entrate *EJ (fine lavoro), contengono le-‘seguenti informazioni: 

1. L'ora di inizio del lavoro. 

2. L'ora di fine del lavoro. 


3. La quantità di tempo impiegata per eseguire il lavoro (valido solo per i 
lavori che durano meno di 24 ore). 


4. La data in cui il lavoro è stato eseguito. 

5. L'ID utente dell'operatore che ha eseguito il lavoro. 

6. L'unità video dalla quale il lavoro è stato eseguito. 

7. 4 nome della procedura che ha iniziato il lavoro. 

8. Se il lavoro era un lavoro per terminali richiedenti multipli (MRT), un 


lavoro per terminale non richiedente (NRT) eseguito dalla coda di la- 
vori (JOBOQ) o un lavoro per terminale richiedente singolo (vuoto). 


Poggi 


A 


Le entrate *EP (lavoro di fine stampa) contengono le seguenti informazioni: 


1. L'ora di 


inizio del lavoro, 


2. L'ora di fine del lavoro. 


3. La quantità di tempo impiegata per stampare il lavoro. 


4. La data in cui il lavoro è stato stampato. 


5. L'ID utente dell'operatore che ha creato il lavoro di stampa. 


6. L'1D della stampatrice dalla quale il lavoro è stato stampato. 


7. Il nome delia procedura che ha creato il lavoro di stampa. 
8. I nome del lavoro che ha creato il lavoro di stampa. 
9. Il numero di modulo usato con l'emissione stampata. 


10. Un codice di completamento lavoro a due caratteri: 


NC 
CP 
GP 
HP 
PP 
TP 


TERM. indica l'ID di terminale dell'unità video o della stampatrice associato con 


Completamento normale. 

Un operatore ha cancellato il lavoro di stampa. 
Un operatore ha modificato il lavoro di stampa. 
Un operatore ha congelato il lavoro di stampa. 
Un operatore ha interrotto il lavoro di stampa. 
Un operatore ha riavviato il lavoro di stampa. 


l'entrata del file storico, cronologico. 


UTENTE: indica "ID utente dell'operatore associato con l’entrata di file storico, 


cronologico. 


NOME LAV.: indica il lavoro associato con l’entrata di file storico, cronologico. 


ORA: indica l'ora in cui la specifica è stata registrata sul file storico, cronologico, 
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PROCEDURA ICFDEBUG 


La procedura ICFDEBUG controlla l'esecuzione del programma di ricerca e cor- 
rezione errori dell'Interactive Communications. Feature (SSP-ICF). Dopo che il 
file di ricerca e correzione degli errori viene visualizzato o stampato, il file viene 
cancellato. } 


Per ulteriori informazioni su SSP-ICF e la procedura ICFDEBUG, vedere il ma- 
nuale SSP-CF Guide and Examples, 


ICFDEBUG ON 
OFF 
CRT 


CRT,nome lavoro 
PRINT 
PRINT,nome lavoro 





ON specifica che deve essere avviato il programma di ricerca e correzione degli 
errori. ll programma inizia registrando le attività SSP-ICF in un file su disco. 
Qualsiasi file precedente creato dalla procedura ICFDEBUG viene cancellato. 


»* . PI . I . . . 
OFF specifica che il programma di ricerca e correzione degli errori deve essere 
interrotto. Non deve essere registrata alcuna ulteriore attività SSP-ICF e il fi- 


le su disco creato dalla procedura ICFDEBUG viene cancellato. 


CRT specifica che il file precedentemente creato dalla procedura ICFDEBUG de- 
ve essere visualizzato. 


CRT,nome lavoro specifica che le entrate del lavoro indicato devono essere visua- 
lizzate dal file precedentemente creato dalla procedura ICFDEBUG. 


nome lavoro specifica il nome di 8 caratteri del lavoro. E’ possibile usare il co- 
mando di controllo STATUS USERS per visualizzare i nomi dei lavori. 


PRINT specifica che il file precedentemente creato dalla procedura ICFDEBUG 
deve essere stampato. 


PRINT,nome lavoro specifica che le entrate del lavoro indicato devono essere 
stampate dal file precedentemente creato dalla procedura ICFDEBUG, 


nome lavoro specifica il nome del lavoro di 8 caratteri. E’ possibile usare il co- 
mando di controllo STATUS USERS per visualizzare i nomi dei lavori. 
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Esempio 1 


Questo esempio mostra come avviare il programma di ricerca e correzione errori 
de: dell'SSP. : 


ICFDEBUG ON 


Esempio 2 


Questo esempio mostra come stampare l’attività registrata dopo l'immissione 
del comando di procedura ICFDEBUG ON. 


ICFDEBUG PRINT 


PROCEDURA ICVERIFY 
La procedura ICVERIFY verifica l'installazione dei sottosistemi Interactive Com- 


munications Feature (SSP-ICF). Vedere il manuale SSP-/CF Guide and Examples 
per informazioni sull'esecuzione di questa procedura. 


PROCEDURA IDDUDCT 


La procedura IDDUDCT richiama il programma di utilità definizione dati interattiva 
n per creare, revisionare, cancellare, ridenominare, o stampare il dizionario dati. 


Per maggiori informazioni vedere l'informazione in linea. Per leggere l'informazione 
in linea: 


e Eseguire la procedura READINFO. Per l'IDDU specificare: 


READINFO #IDDDOC, #IDDFLDR 


e Scegliere l'opzione 11 dal menù di utilizzo IDDU. 


e Premere il tasto di ausilio da qualsiasi schermo IDDU. 


IDDUDCT 


La procedura IDDUDCT non ha parametri 
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PROCEDURA IDDUDEN 


La procedura IDDUDFN richiama il programma di utilità definizione dati interattiva per 
creare, revisionare, copiare, cancellare, ridenominare, stampare o visualizzare una lista 
di campi, tracciati o definizioni dati. 


Per maggiori informazioni vedere l'informazione in linea. Per leggere l'informazione 
in linea: 


* Eseguire la procedura READINFO. Per l'IDDU specificare: 


READINFO #IDDDOC, #IDDFLDR 


® Scegliere l'opzione 11 dal menù di utilizzo IDDU. 


e Premere il tasto di ausilio da qualsiasi schermo IDDU. 


IDDUDFN 


La procedura IDDUDFN non ha parametri. 


PROCEDURA IDDUDISK 


La procedura IDDUDISK richiama il programma di utilità definizione dati interattiva 
| per creare, collegare o scollegare un file su disco, o immettere o variare dati in un 
file su disco. 


Per maggiori informazioni vedere l'informazione in linea. Per leggere l'informazione 
in linea: 


e Eseguire la procedura READINFO. Per l’IDDU specificare: 


READINFO #IDDDOC, #IDDFLDR 


e Scegliere l'opzione 11 dal menù di utilizzo IDDU. 


. Premere il tasto di ausilio da qualsiasi schermo IDDU. 


IDDUDISK 


La procedura IDDUDISK non ha parametri. 
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PROCEDURA IDDULINK 


La procedura IDDULINK collega e scollega un file su disco con una definizione di 








ui file in un dizionario dati. Il collegamento ad una definizione file permette ad un pro- 

gramma di accedere al file come è definito dalla definizione file. 
Per maggiori informazioni vedere l'informazione in linea. Per leggere l’informazione 
in linea: 

* Eseguire la procedura READINFO. Per l’IDDU specificare: 

READINFO #IDDDOC,#IDDFLDR 

e Scegliere l'opzione 11 dal menù di utilizzo IDDU. 

e Premere il tasto di ausilio da qualsiasi schermo IDDU. 

IDDULINK LINK,nome file,nome dizionario dati,definizione file, mmggaa 
gemmaa 
aammgg 

Per collegare un file su disco con una definizione dati: 

IDDULINK UNLINK,nome file 

Per scollegare tutte le definizioni in un dizionario dati: 
IDDULINK UNLINK,ALL,nome dizionario file 
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LINK specifica che il file su disco deve essere associato con la definizione file nel 
dizionario dati. 


UNLINK specifica che il legame tra il file su disco e la definizione del file deve 
essere rimosso. 


nome file specifica il nome del file che deve essere collegato o scollegato. 


ALL specifica che tutte le definizioni file nel dizionario dati devono essere 
scollegate dai loro file su disco associati. 


nome dizionario dati specifica il dizionario dati che contiene le definizioni file 
che devono essere collegate o scollegate. Se il primo parametro è UNLINK ed 
il secondo è un nome di file, questo parametro non è richiesto. 


definizione file specifica la definizione file da coliegare al file su disco. Se il primo 
parametro è UNLINK, questo parametro non è richiesto. 


mmddyy, ddmmyy, o yymmdd specifica la data di creazione del file da collegare. La 
data, se indicata, se deve essere nel formato della sessione; utilizzare il coman- 
do STATUS SESSION per determinare il formato data della sessione. Se la data 
non viene indicata ed esistono più file con lo stesso nome, viene collegato il 
file con data di creazione più recente 


PROCEDURA IDDUPRT 
= La procedura IDDUPRT stampa campi, tracciati o definizioni file in un dizionario dati. 


Per maggiori informazioni vedere l'informazione in linea. Per leggere l'informazione 
in linea: 


e Eseguire la procedura READINFO. Per l’IDDU specificare: 


READINFO #IDDOC,#IDDFLDR 


® = Scegliere l'opzione 11 dal menù di utilizzo IDDU. 


e Premere il tasto di ausilio da qualsiasi schermo IDDU. 


SHORT s| FILE s| ALL 
EXTENDED FORMAT nome definizione 


ALL FIELD 





nome dizionario dati specifica il dizionario dati che contiene le definizioni da stampare. 


SHORT specifica che deve essere stampata una breve versione della definizione. 

Questa contiene la data dell'ultima revisione della definizione ed il nome utente 

che l'ha revisionata; la data della creazione della definizione ed il nome utente 

che l’ha creata; e un piccolo commento. Una breve versione della definizione 

di un campo include il tipo dei dati, la lunghezza del campo, e il numero dei de- 

2a cimali permessi nel campo. Una breve definizione di tracciato include la lunghezza 
del record di immissione ed emissione e la lista del campo. Una breve definizio- 

ne di file include il tipo di file, la lunghezza massima del record ed una lista trac- 

ciato record. Se non viene specificato alcun parametro, viene assunto SHORT. 


EXTENDED specifica che deve essere stampata una versione estesa della 
‘definizione. La versione estesa comprende tutte le informazioni contenute nel- 
la definizione breve più un lungo commento ed una lista di dove la definizione 
è usata. La versione estesa di una definizione campo include attributi aggiunti- 
vi e una preparazione di stampa per numeri. Una definizione di tracciato estesa 
include attributi di comunicazione e codici di identificazione record. 


ALL specifica che deve essere stampata una versione estesa della definizione. Per 
una definizione di file, vengono stampate tutte le versioni estese di definizione 
tracciato nel file. Per una definizione di tracciato, vengono stampate tutte le 
versioni estese di definizioni file nel tracciato. 


FILE specifica che devono essere stampate tutte le definizioni di file contenute nel 
dizionario dati indicato. 


PEN 
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FORMAT specifica che devono essere stampate una o tutte le definizioni di 
tracciato contenute nel dizionario dati indicati. 


FIELD specifica che devono essere stampate una o tutte le definizioni di 
campo contenute nel dizionario dati indicato. 


ALL specifica che devono essere stampate tutte ie definizioni contenute nel 
dizionario dati specificato di un certo tipo. Se non viene specificato alcun para- 


metro, viene assunto ALL. 


nome definizione specifica che deve essere stampata una singola definizione di 
un tipo indicato. 


PROCEDURA IDDURBLD 


La procedura IDDURBLD permette ai programmi ed a quelli di utilità di utilizzare una 
versione aggiornata di una definizione dati. Le modifiche vengono normalmente ef- 
fettuate quando l'IDDU termina. La versione aggiornata della definizione è salvata 
nel dizionario dati. 


Per maggiori informazioni vedere l'informazione in linea. Per leggere l'informazione 
in linea: 


e Eseguire la procedura READINFO. Per l’IDDU specificare: 


READINFO #IDDDOC, #IDDFLDR 


e Scegliere l'opzione 11 dal menù di utilizzo IDDU. 


e Premere il tasto di ausilio da qualsiasi schermo IDDU. 


IDDURBLD nome dizionario dati 





nome dizionario dati specifica il dizionario dati contenente la definizione dati e le 
definizioni da variare. 
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PROCEDURA IDDUXLAT 


Le specifiche origine RPG possono essere usate per descrivere il contenuto e la di- 
sposizione dei file su disco utilizzati dal programma RPG. Queste descrizioni di file 
sono interne al programma e possono essere utilizzate solo dal programma. | dati 
di questi file sono denominati datì definizione programma. 


Anche il programma di utilità interattivo (IDDU) permette di descrivere il contenuto 
e le disposizioni del file. Queste descrizioni sono denominate campo, tracciato, e 
definizione file, e sono memorizzate su un dizionario dati. } dati nei file descritti dal- 
le definizioni IDDU sono denominati dati descritti esternamente. 


Si può utilizzare l'IDDU per creare o gestire definizioni rispondendo semplicemente 
alle richieste di uno schermo. Le definizioni IDDU sono usate dal Query/36 e Di- 
splay Write/36. Le specifiche origine RPG non sono richieste e non sono utilizzate 
dal Query/36 e dal Display Write/36. 


La procedura IDDUXLAT trasforma le specifiche origine RPG o le definizioni dati Text 
Management System (TMS) in definizione IDDU. Con questa procedura si può fa- 
cilmente creare un nuovo campo, tracciato o definizione file IDDU utilizzando le in- 
formazioni contenute nelie specifiche di un programma origine RPG. 


Per creare le definizioni IDDU, la procedura IDDUXLAT interpreta le entrate delle se- 
guenti specifiche RPG: 


* Specifiche H (controllo) 
e Specifiche F (file) 
® Specifiche | (immissione) 


Queste specifiche devono descrivere file su disco di immissione o aggiornamento 
(eccetto file indirizzi record o file tabelle); tutti gli altri tipi di file, compresi i file di 
lavoro e di comunicazione, sono ignorati e non possono essere trasformati dalla pro- 
cedura IDDUXLAT. 


Utilizzando le specifiche | del membro origine RPG, la procedura IDDUXLAT crea 
le equivalenti definizioni campo IDDU e definizioni tracciato IDDU per ciascun tipo 
record contenuto nel file. Utilizza inoltre le specifiche H e F per creare le definizioni 
file IDDU per ciascun file descritto nelle specifiche origine RPG. 
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Utilizzando la procedura IDDUXLAT, si può specificare che soltanto certi particolari 
membri origine dovranno essere trasferiti. Ad esempio tutti i membri origine conte- 
nuti in una particolare libreria, possono essere trasferiti in definizione dati IDDU. In 
aggiunta si può scegliere di trasferire uno specifico membro origine o una serie di 
membri origine. Ad esempio si può trasferire soltanto il membro origine denomina- 
to RPGPROG1, o tutti i membri origine che hanno nomi compresi tra PROGAAA e 
PROGLLL (PROGAAA viene trasferito, PROGZZZ no). 


Le definizioni IDDU create dalla procedura IDDUXLAT sono poste in uno specifico 
dizionario dati IDDU. 


Per aiuto sull'utilizzo delle definizioni IDDU, si possono stampare fe seguenti infor- 
mazioni: 


@e Una lista di parametri da specificare nella procedura IDDUXLAT. 


e Unalista di specifiche origine trasferita dalla procedura IDDUXLAT e gli errori 
riscontrati. 


e Una lista di definizioni IDDU create dalla procedura IDDUXLAT. 


e Statistiche che mostrino il numero degli errori riscontrati nelle specifiche origi- 
ne ed il numero di definizioni IDDU create dalla procedura IDDUXLAT. 


Una volta collegate le definizioni IDDU edi file (si veda ia procedura IDDULINK per 
maggiori informazioni), le definizioni possono essere utilizzate dai seguenti programmi 
di utilità: 


e Query/36, per produrre rapporti dai dati contenuti nei file. 


e Display Write/36 per utilizzare il Query/36 per inserire i dati contenuti nel file 
in un documento. 


Per maggiori informazioni sull’IDDU, leggere il manuale /ntroduzione all’IDDU 
SC13-5121 o l'informazione in linea per l'IDDU (scegliere l'opzione 11 del menù 
di ausilio sistema IDDU). Per maggiori informazioni sulia procedura IDDUXLAT, ve- 
dere l’appendice G. 


La procedura IDDUXLAT può essere eseguita da qualsiasi terminale. 


nome membro origine ALL 
nome membro iniziale 
ALL 


IDDUXLAT nome dizionario dati, & nome membro parziale a membro A 


nome libreria origine |,|l sottotipo | , | prefisso nome definizione 
libreria corrente RPG FI 

ARP 

RAA 

TEXT 

ANY 


PRINT 
NOPRINT 





nome dizionario dati specifica il nome del dizionario dati IDDU in cui sono memorizzati 
i campi, formati e definizioni file IDDU. Un nome deve essere spetificato; uno 
specifico dizionario dati deve già esistere sui sistema. Utilizzare ia procedura 
IDDUDCT per creare un dizionario dati. 


nome membro parziale specifica una stringa di caratteri (da 1 a 7) usati per 
scegliere i membri origine da trasferire con la procedura IDDUXLAT. Se come 
membro finale è specificato ALL, la procedura IDDUXLAT trasferisce tutti i mem- 
bri origine il cui nome inizia con i caratteri indicati nella stringa. 

nome membro origine specifica il nome di un singolo membro origine contenente 
specifiche origine utilizzate per creare definizioni IDDU. Se si specifica il nome 
del membro origine, e non il nome membro finale, viene trasferito soltanto il 
membro origine specificato. 


nome membro iniziale specifica il primo membro origine di un gruppo di membri origine 

- che devono essere trasferiti dalla procedura IDDUXLAT. Se si specifica anche 

il nome membro finale, vengono trasferiti tutti i membri origine compresi tra 
l'iniziale ed il finale. 
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ALL Se indicato nel parametro membro origine, tutti i membri origine vengono 
trasferiti dalla procedura IDDUXLAT. Se si specifica il nome membro finale, non 
si può indicare ALL: 


Se indicato, nel parametro membro finale, tutti i membri origine specificati con 
il nome membro parziale vengono trasferiti. 


Si può indicare il parametro sottotipo (RPG, ARP, RAA, TEXT o ANY) per indi- 
care che soltanto membri origine di un particolare sottotipo vengono trasferiti. 


nome membro finale specifica l’ultimo membro origine in un gruppo di membri origine 
trasferiti dalla procedura IDDUXLAT. 


Se si specifica anche il nome iniziale, tutti imembri aventi un nome compreso 
tra l'iniziale ed il finale vengono trasferiti. 


nome libreria origine specifica il particolare tipo di membro origine da trasferire. Si 
dovrà specificare quanto segue: 


RPG specifica che soltanto membri origine RPG sono da trasferire. 


ARP specifica che soltanto membri origine RPG AUTO REPORT sono da tra- 
sferire. 


RAA specifica che soltanto membri origine RPG e RPG AUTO REPORT sono da 
trasferire. 


TEXT specifica che soltanto membri contenenti definizioni dati TMS, sono da tra- 
sferire. Le definizioni dati TMS devono essere contenute in una libreria ori- 
gine denominata #DATADEF., 


ANY specifica che sono da trasferire tutti i membri indicati nel secondo e terzo 
parametro. Se non si specifica il sottotipo, viene assunto ANY. 


TN 


Esempio 1 
Trasferimento di tutte le definizioni dati TMS contenute nella libreria denominata 
#DATADEF. Le definizioni IDDU create saranno memorizzate nel dizionario dati IDDU 


denominato DICTAB. Se vengono trovati nomi duplicati, i nomi delle definizioni ini- 
zieranno con i caratteri FI. Viene richiesta la stampa. 


IDDUXLAT DICTABC,ALL,, DATADEF,TEXT,FI,PRINT 


Esempio 2 
Trasferimento di tutti i membri origine contenuti nella libreria RPGLIB. Le definizioni 


IDDU verranno memorizzate nel dizionario dati IDDU DICTABC. Se vengono trovati 
nomi duplicati, i nomi delle definizioni inizieranno con FI. Viene richiesta la stampa 


IDDUXLAT DICTABC,ALL, ,RPGLIB, ANY 


Esempio 3 
Trasferimento di tutti ì membri origine RPG Auto Report contenuti nella libreria 
RPGLIB. Le definizioni IDDU verranno memorizzate nei dizionario dati IDDU deno- 


minato DICTABC. Se vengono trovati nomi duplicati, i nomi delle definizioni inizie- 
ranno con AR. Non viene richiesta la stampa. 


IDDUXLAT DICTABC,ALL, ,RPGLIB, ARP,AR, NOPRINT 


Esempio 4 
Trasferimento di un singolo membro origine denominato RPGPROG1 contenuto nella 
libreria RPGLIB. Le definizioni IDDU verranno memorizzate nel dizionario dati IDDU 
denominato DICTABC. Se vengono trovati nomi duplicati, i nomi delle definizioni 
inizieranno con PR. Non viene richiesta la stampa. 


IDDUXLAT DICTABC,RPGPROGI1, ,RPGLIB,,PR,NOPRINT 
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prefisso nome definizione specifica un prefisso di due caratteri utilizzato per generare 


nomi di definizioni. 


Quando è possibile la procedura IDDUXLAT utilizza il nome campo presente sulle 
specifiche | come nome del corrispondente definizione campo. In alcuni casi, 
pertanto, il nome campo potrebbe essere uguale al nome di una esistente defi- 
nizione campo. Se il tipo dati, la lunghezza campo, ed il numero di posizioni de- 
cimali di un campo descritto da una definizione campo sono diversi da quelli 
descritti dalle specifiche I, la procedura IDDUXLAT genera un nome definizione 
campo diverso e mai utilizzato. La procedura IDDUXLAT utilizza il prefisso no- 
me definizione ed aggiunge ad esso un numero progressivo di quattro cifre. Il 
nome definizione campo generato sarà così nella forma xxnnnn, dove xx è il 
prefisso nome definizione e nnnn è un numero sequenziale. 


Se il campo descritto dalle specifiche | è uguale a quello descritto da una defini- 
zione campo esistente, non viene creata una nuova definizione campo. 


Il prefisso è usato anche per»creare nomi definizioni formato e definizioni file. 
I nomi delle definizioni formato Sono nella forma xxnnnn, dove xx è il prefisso 
nome definizione e nnnn è un numero sequenziale, Se il nome file specificato 
nelle specifiche F è uguale a quello di una già esistente definizione file, il prefis- 
so viene usato per creare un nome differente e mai utilizzato prima. Il nome del- 
la definizione file è nella forma xxnnnn, dove xx è il prefisso nome definizione 
e nnnn è un numero sequenziale. 


Se non si specifica un prefisso nome definizione, viene assunto FI. 


PRINT specifica che viene stampato quanto segue: 


e Unalista di parametri specificati nella procedura IDDUXLAT. 


® Unalista delle specifiche origine trasferite della procedura IDDUXLAT e gli 
errori riscontrati. i 


e Una lista di definizioni IDDU create dalla procedura IDDUXLAT. 


® Statistiche che mostrino il numero di errori riscontrati nelle specifiche ori- 
gine ed il numero di definizioni IDDU create dalia procedura IDDUXLAT. 


Print è if valore assunto. 


NOPRINT indica che non si vuole la stampa. 


Esempio 5 


Trasferimento di un gruppo di membri origine contenuti nella libreria RPGLIB. Il pri- 
mo membro origine da trasferire è PROGAAA e l’ultimo è PROGLLL. Dovranno es- 
sere trasferiti soltanto membri origine RPG. Le definizioni IDDU saranno memorizzate 
nel dizionario datì IDDU denominato DICTABC. Se vengono trovati nomi duplicati, 
i nomi delle definizioni inizieranno con FI. Viene richiesta ia stampa. 


IDDUXLAT DICTABC,PROGAAA, PROGLLL, RPGLIB, RPG. 


Esempio 6 


Trasferimento di un gruppo di membri origine contenuti nella libreria RPGLIB. Tutti 
i membri origine il cui nome inizia con PROG dovranno essere trasferiti. Le definizio- 
ni IDDU saranno memorizzate nel dizionario dati IDDU denominato DICTABC. Se 
vengono trovati nomi duplicati, i nomi delle definizioni inizieranno con FI. Viene ri- 
chiesta la stampa. 


IDDUXLAT DICTABC,PROG,ALL,RPGLIB, ANY 
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PROCEDURA INIT 


La procedura INIT prepara uno o più minidischi in modo da poterli usare per 
salvare file e librerie. Questa preparazione è detta inizializzazione. E’ possibile 
inoltre con essa denominare o cancellare un minidisco. La procedura INIT esegue 
aleune o tutte delle seguenti funzioni: 


Scrive nomi di identificazione sul minidisco, denominati ID di volume (detti 
anche identificatori di volume o ID pack) e I"ID del proprietario. 


Inizializza la porzione di controllo del minidisco (cilindro 0). 
Assicura che il minidisco sia utilizzabile. 


Scrive indirizzi di settore sul minidisco. 


La procedura INIT esegue il programma di utilità $INIT. 


iéa volume .|ia proprietario|,| RENAME |,|locazione iniziale|, 


data programmal |OWNERID DELETE Sl 





FORMAT 52 

FORMAT2 53 
Ml.nn 
M2.nn 


locazione finale 
locazione iniziale 





Sl 
S2 
5S3 
Ml.nn 
M2.nn 





id volume specifica quanto segue: 


e Se viene indicato RENAME, FORMAT o FORMAT?, questo parametro 
specifica l'ID di volume da assegnare al minidisco, che può comprendere 
da 1 a 6 caratteri (alfabetici o numerici). L'ID di volume è disposto nel 
campo ID volume dell'identificazione del volume di minidisco. Se non 
viene specificato un ID di volume, viene scritta la data del programma 


(data del passo di lavoro) nel campo ID di volume. La data è scritta 
nel formato YYMMDD ({anno-mese-giorno). 


e Se viene specificato DELETE, questo parametro specifica VID di volume 
del minidisco dal quale devono essere cancellati i file. L'ID di volume 
specificato è controllato a fronte dell’ID di volume esistente nel minidi- 
sco per assicurarsi che sia inserito il minidisco corretto. 


id proprietario specifica l'ID del proprietario del minidisco e può comprendere da 
1 a 14 caratteri (alfabetici o numerici). Se viene specificato un {D di proprietario 
o se viene specificato anche RENAME, FORMAT o FORMAT?2, l'ID del proprie- 
tario viene disposto nel campo ID del proprietario dell’identificazione di volume 
minidisco. Se non viene specificato un ID di proprietario, viene scritta la parola 
OWNERID nel campo ID del proprietario. 


Can 


RENAME specifica che il minidisco deve essere ridenominato (cioè che ai campi 
{D di volume e del proprietario nel minidisco devono essere assegnati nuovi 
valori). Qualsiasi file sul minidisco non viene influenzato. Se non viene speci- 
ficato un parametro, si presume RENAME. 


DELETE specifica che dal minidisco deve essere rimosso qualsiasi file attivo sul 
minidisco, facendo così spazio sul minidisco per accogliere ulteriori informa- 
zioni. 


FORMAT specifica che deve essere inizializzata la superficie dei minidisco. Per 
un minidisco 1, il minidisco è inizializzato nel formato a 128 byte per setto- 
re. Per un minidisco 2D il minidisco è inizializzato nel formato 256 byte per 
settore. 


Se viene specificato FORMAT, il minidisco può contenere file in formato 
base di interscambio. Per ulteriori informazioni sui file in formato base di 
interscambio, vedere la Procedura TRANSFER. 


FORMAT?2 specifica come deve essere inizializzata la superficie del minidisco. Per 
un minidisco 1, il minidisco è inizializzato nel formato a 512 byte per setto- 
re. Per un minidisco 2D, il minidisco è inizializzato nel formato a 1024 byte 
per settore. Questo dovrebbe essere il formato generalmente usato. | minidi- 
schi FORMAT2 non possono contenere file in formato base di interscambio. 


locazione iniziale specifica la locazione iniziale dell’alimentatore del minidisco da 
usare. Se non è specificato un parametro, si presume S1. Questo parametro 
è ignorato se il sistema non dispone di un modulo a caricatore per minidischi. 
La locazione iniziale deve essere minore della locazione finale. 


locazione finale specifica la locazione finale dell’alimentatore minidischi da usare. 
Se non è specificato un parametro, si presume la locazione iniziale. Questo 


< 


parametro è ignorato se il sistema non dispone di un modulo a caricatore. 


La locazione finale (se specificata) deve essere maggiore delia locazione ini- 
ziale e non deve provocare un salto dagli alimentatori del minidisco (S1, S2, 
S3) agli alimentatori del caricatore (M1 e M2). Non è cioè corretto specifica- 
re una locazione iniziale di S3 e una locazione finale dì M1. E’ possibile spe- 
cificare una locazione iniziale nel caricatore 1 e una locazione finale nel cari- 
catore 2. 
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Le locazioni iniziali e finali possono essere una fra le seguenti: 

$1, $2 o S3 specifica uno dei tre alimentatori del minidisco. 

M1 o M2 specifica uno dei due alimentatori del caricatore. Se viene specificato 
M1 o M2 come locazione iniziale, e non viene specificata alcuna locazione 
finale, viene elaborato l’intero caricatore (tutti e 10 gli alimentatori). Specifi- 


care M1î o M2 come locazione finale equivale rispettivamente a specificare 
M1.10 o M2.10. 


M1.nn o M2.nn indica una posizione specifica nell'ambito di un caricatore. nn è 
un numero da 01 a 10 che specifica la posizione nell’ambito del caricatore. 
Esempio 1 


Ridenominare un minidisco in modo che il nuovo ID di volume sia VOLOO1 e il 
nuovo ID di proprietario sia YOURNAME. Il minidisco è nell'alimentatore S1. 


INIT VOLOOi,YOURNAME 


Esempio 2 


Questo esempio mostra come inizializzare 10 minidischi tipo 1 nel formato a 512 
byte {o 10 minidischi tipo 2D nel formato a 1024 byte) in modo che l'ID di vo- 
lume sia VOLO0O2 e 1'ID di proprietario sia OWNERID. | minidischi sono conte- 
nuti in un caricatore che è disposto nell’alimentatore M1. 


INIT VOL002, sFORMAT2,M1 


dA 


| PROCEDURA INITDIAG 


La procedura INITDIAG inizializza i minidischi diagnostici (microprogramma). 
Può essere eseguita da qualsiasi terminale; richiamata con EVOKE o eseguita dalla 


coda lavori. 


Î La procedura INITDIAG esegue il programma di utilità $INIT. 


INITDIAG alloggiamento iniziale | , | alloggiamento finale 
SL alloggiamento iniziale 
SI 
S2 
S3 





M] 
M2 
Ml.nn 
M2.nn 





locazione iniziale specifica la locazione iniziale dell’alimentatore del minidisco da usa- 
re. Se non è specificato un parametro, si presume S1. Questo parametro è igno- 
rato se il sistema non dispone di un modulo a caricatore per minidischi. La lo- 
cazione iniziale deve essere minore della locazione finale. 

% 

locazione finale specifica la locazione finale dell’alimentatore minidisci da usare. Se 
non è specificato un parametro, si presume la locazione iniziale. Questo para- 
metro è ignorato se il sistema non dispone di un modulo a caricatore. 


La locazione finale (se specificata) deve essere maggiore della locazione inizia- 
le e non deve provocare un salto dagli alimentatori del minidisco (51, S2, S3) 
agli alimentatori del caricatore {(M1 e M2). Non è cioè corretto specificare una 
locazione iniziale. DS3 è una locazione finale DM1. È possibile specificare una 
locazione iniziale nel caricatore 1 e una locazione finale nel caricatore 2. 


I Le locazioni iniziali e finali possono essere una fra le seguenti: 
| S1, S2 o $S3 specifica uno dei tre alimentatori del minidisco. 
M1 o M2 specifica uno dei due alimentatòri del caricatore. Se viene specificato M1 

o M2 come locazione iniziale, e non viene specificata alcuna locazione finale, 
viene elaborato l’intero caricatore (tutti e 10 gli alimentatori). Specificare M1 
o M2 come locazione finale equivale rispettivamente a specificare M1.10 o 
M2.10. 

| M1.nn o M2.nn indica una posizione specifica nell’ambito di un caricatore. nn è un 
numero da 01 a 10 che specifica la posizione nell’ambito del caricatore. 

| Esempio 


| Per inizializzare un minidisco posto nell’alloggiamento 2. 


I INITDIAG 52 
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308.2 


Pagina lasciata intenzionalmente bianca 


PROCEDURA INQUIRY 


La procedura INQUIRY consente di visualizzare un file su disco usando il DFU. 
Le specifiche di file vengono usate per definire il formato dei record nel file. Per 
ulteriori informazioni sul DFU, vedere il manuale Programma di Utilità per file 
di dati (DFU), 


INQUIRY nome file,nome programma fu, [none membro origine file[,, 
1 


D si NN ,[nome membro origine afu] sa 
Z NY 
B 


YN 
YY 
GO 


nome libreria .[ nome membro origine tracciato vigeo || nome file su 1500 ] 


libreria corrente 


nome file specifica i! file da visualizzare. Il nome file può comprendere da 1 a 8 
caratteri alfanumerici. ; 


nome programma dfu specifica il programma DFU da usare per elaborare il file. 
Se il programma non esiste nella libreria, il DFU avvia le procedure di impo- 
stazione. Se il programma esiste nella libreria, il DFU va direttamente a vi- 
sualizzare il file. 


nome membro origine file specifica il membro origine contenente la descrizione 
di file (specifiche F) e le specifiche di immissione dei record (specifiche 1) che 
descrivono il file da elaborare. Questo membro può contenere una o più serie 
di descrizioni di file e di specifiche di immissione o un intero programma 
RPG II. La descrizione dei file e le specifiche di immissione che corrispon- 
dono ai file sono interpretate come descrizione dei dati. 


Questo parametro è richiesto se non viene specificato. Questo parametro è 
richiesto se la descrizione di formato specificato non esiste e deve essere ese- 
guita l'impostazione dei lavori. 


D, Z o B indica se i campi numerici non a chiave devono essere riempiti con zeri 
(esadecimale F0) o con spazi in bianco. Le sole entrate ammesse sono D, Z o 
B. Se non è specificato alcun parametro, si presume D. 


D o B specifica un file di dati con riempimento di spazi vuoti dei campi nu- 
merici senza chiave. 


Z specifica un file di dati con riempimento di zeri dei campi numerici senza 
chiave. 
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NN, NY, YN, YY, o GO indica come devono essere elaborate le specifiche origi- 


x 


ne. Questo parametro è usato se il programma DFU non esiste e deve essere 
eseguita l'impostazione. Esso indica se le specifiche DFU per questo lavoro 
sono già memorizzate nella libreria e se devono essere memorizzate nella li- 
breria quando l'impostazione è terminata. Il membro origine delle specifiche 
DFU è memorizzato o cercato nella libreria corrente, a meno che non sia 
specificato un nome di libreria, 


NN: ie specifiche DFU memorizzate non sono usate per l'impostazione di 
questo programma. Viene richiesto di creare le specifiche ma queste non ven- 
gono salvate dalla libreria. 


NY: Le specifiche DFU memorizzate non sono usate per questa impostazio- 
ne di programma. Viene richiesto di creare le specifiche; una volta create, 
sono memorizzate nella libreria. 


YN: le specifiche memorizzate DFU sono usate per l'impostazione di questo 
programma. Non è richiesto ma è possibile aggiornare le specifiche prima che 
venga creata la descrizione di formato. Se si modificano le specifiche sull’uni- 
tà video, viene interessato soltanto questo programma; le modifiche non sono 
memorizzate nella libreria. 


YY: le specifiche DFU memorizzate sono usate per questa impostazione di 
programma. sNon è richiesto ma è possibile aggiornare le specifiche prima che 
it programma DFU sia creato. Le specifiche nella libreria sono sostituite dalle 
specifiche aggiornate. 


GO: le specifiche DFU memorizzate sono usate per questa impostazione di 
programma. Non è necessario e non è possibile aggiornare le specifiche prima 
che venga creato il programma DFU a meno che non si trovino errori, Se si 
trovano errori nelle spericifiche, occorre correggere le specifiche prima di 
creare il programma DFU. in ogni caso, le specifiche DFU memorizzate non 


‘ vengono cambiate. 


nome membro origine dfu specifica il membro origine che contiene o conterrà le 


specifiche DFU salvate. Questo parametro è richiesto se il parametro di ela- 
borazione origine DFU non è NN. 


nome libreria specifica la libreria che contiene o che conterrà le specifiche DFU. 


Tutti i membri di fibreria associati con il lavoro DFU sono cercati o memo- 
rizzati in questa libreria. Se non viene specificato questo parametro, si pre- 
sume la libreria corrente. 


nome membro arigine tracciato video specifica il membro in cui il DFU deve me- 


morizzare le specifiche origine tracciato video quando è stato impostato un 
lavoro DFU. Se viene specificato questo parametro è possibile in un secondo 
tempo cambiare le specifiche origine tracciato video generate, compilarle 
per sostituire il membro oggetto tracciato video esistente e quindi eseguire 
lo stesso lavoro DFU con i dati visualizzati nei campi ridefiniti. 


nome file su disco specifica il nome del file nella VTOC del disco da visualizzare, 


se è diverso dal nome specificato nel programma DFU. Con questo parametro 
specificato, diversi programmi, che si riferiscono a differenti file logici, posso- 


no visualizzare lo stesso file su disco. È un parametro opzionale. 


Esempio 


Questo esempio mostra come visualizzare un file su disco denominato FILE1; le 
specifiche origine DFU da usare per visualizzare i record sono denominate 
DFUSETUP. Le specifiche sono nella libreria corrente. 


INQUIRY FILEl,DFILlFM,,,,CO,DFUSETUP 


| PROCEDURA ITF 


La procedura ITF (Interactive Terminal-Facility) consente all'utente del Sistema/36 
di inviare e ricevere dati per mezzo di applicazioni quali ad esempio il TELEMAIL * 
e il servizio messaggi elettronici offerto dalla GTE Telenet per terminali asincroni. 
Prima di avviare la procedura ITF, è necessario abilitare un sottosistema asincrono 
con la procedura ENABLE. Per maggiori informazioni su ITF fare riferimento al ma- 
nuale Using the Asyncronous Communications Support. 


nome ubicazione 





nome ubicazione specifica il nome dell'ubicazione remota con cui si vuole 
comunicare. 


I Esempio 
| Per comunicare con il nome di ubicazione remota Chicago. 


| ITF CHICAGO 


PROCEDURA IWDOWNL 


| La procedura IWDOWNL copia la parte PC del supporto PC/36 dal Sistema/36, su 
un Personai Computer IBM. 


Per maggiori informazioni vedere il manuale PC Support/36 Technical Reference. 


IWDOWNL 


La procedura IWDOWNL non ha parametri. 


1 TELEMAIL e Telenet sono servizi registrati della GTE. 
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PROCEDURA IWLOAD 


La procedura IWLOAD crea un libreria denominata #IWLIB e vi copia il supporto 
PC/36; copia anche supporti addizionali nella libreria di sistema (# LIBRARY). Sono 
inoltre copiati da minidisco due file #IWPCLD1 e #IWPCLD2. Questi file {(cono- 
sciuti anche come dischi virtuali) contengono una parte del supporto PC/36 per il 
Personal Computer IBM. Per maggiori informazioni vedere il manuale PC Support/36 
Technical Reference. 


La procedura IWLOAD può anche copiare sia i minidischi irtgiati dal PID (Centro di- 
stribuzione IBM) che quelli creati dalla procedura IWSAVE. Vedere la procedura IW- 
SAVE più avanti su questo manuale. 


La procedura IWLOAD potrebbe modificare il record principale di configurazione, 
con conseguente discordanza con il membro di configurazione. Per modificare il mem- 
bro di configurazione vedere il manuale Modifica della Configurazione del Sistema. 
Si dovrà utilizzare la procedura CNFIGSSP per aggiungere supporto al sistema. Si 
può usare la procedura IWLOAD per ripristinare il supporto che era stato salvato 
con la procedura IWSAVE. 


Se il PC Supporto/ 36non è in uso corrente sul sistema, prima di eseguire IWLOAD, è ne- 
cessario usare la procedura TOLIBR per copiare il file minidisco IWS nella # LIBRARY. 


Se #LIBRARY con il PC Supporto/36 era stata salvata e poi ripristinata prima del- 
l'esecuzione di IWLOAD, non è necessario copiare il file minidisco IWS con la pro- 


cedura TOLIBR. 
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A1, A2, A3 o A4 indica la preferenza del disco; cioè l’unità disco che viene esami- 
nata per prima nella ricerca di spazio disponibile. Se non è disponibile sufficiente 
spazio su quell'unità, vengono esaminate le altre unità (se esistono) e #1W- 
LIB, IWPCLD1 e IWPCLD2 vengono inserite sull'unità disco meno usata. Se 
non è specificata alcuna locazione, ed il sistema dispone di più di un'unità di- 
sco, #!WLIB è inserità sull'unità disco meno usata. 


A1 specifica che #|WLIB, IWPCLD1 e IWPCLD2 devono essere inserite sul 
primo disco, se c'è spazio disponibile. 


A2 specifica che #IWLIB, IWPCLD1 e IWPCLD2 devono essere inserite sul 
secondo disco, se c'è spazio disponibile. 


A3 specifica che #1IWLIB, IWPCLD1 e IWPCLD2 devono essere inserite sul 
terzo disco, se c'è spazio disponibile. 


A4 specifica che #IWLIB, IWPCLD1 e IWPCLD2 devono essere inserite sul 
quarto disco, se c'è spazio disponibile. 


S1, S2 o S3 specifica l'alimentatore a minidischi contenente il primo minidisco 
da usare. Se non è specificata alcuna posizione di minidisco, si presume S1. 


M1.nn 0 M2.nn specifica la locazione deli caricatore che contiene il primo mini- 
disco da usare. M1 indica il primo caricatore e M2 indica il secondo. nn è un 
valore decimale da 01 a 10 che identifica la locazione del minidisco nel carica- 
tore. Specificare M1 equivale a specificare M1.01. Specificare M2 equivale a 
specificare M2.01. 


Esempio 


| Creazione dei file #|WLIB, IWPCLD1 e IWPCLD2 su disco e copia del supporto PC/36 
da minidisco. 


IWLOAD 


PROCEDURA IWSAVE 


La procedura IWSAVE copia il supporto PC/36 su minidischi. li supporto PC/36 vie- 
ne copiato dalle librerie #IWLIB e # LIBRARY. Si può utilizzare la procedura IW- 
LOAD per caricare il supporto PC/36 del minidisco di riserva. !l minidisco deve avere 
un ID di volume PPIWS e deve essere posto nell’alimentatore S1. 


IWSAVE 


La procedura IWSAVE non ha parametri 
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PROCEDURA JOBSTR 


La procedura JOBSTR copia un file su minidisco, su nastro o nastro a cassetta che 
contiene uno o più membri di procedura e membri origine su una libreria specifica- 
ta. È inoltre possibile specificare il nome di una procedura da eseguire dopo che i 
membri nel file su minidisco, su nastro o nastro a cassetta sono stati copiati. 


Il file contenente la procedura e/o i membri origine deve essere leggibile dalla 
procedura JOBSTR. ii file può essere un file nel modo a settori o un file nel 
modo a record, 


I file nel modo a settori ed i file nel modo a record sono creati dalla procedura 
FROMLIBR. E’ ino!tre possibile creare un file nel modo a record usando un si- 
stema diverso dal Sistema/36. Vedere la Procedura FROMLIBAR per ulteriori in- 
formazioni sulla creazione di questi file. 


E' possibile memorizzare come file nel modo a record soltanto i membri di pro- 
cedura e i membri origine. 1 file nel modo a record, possono essere lunghi da 40 
a 120 caratteri, ma tuttì i record in un file devono avere la stessa lunghezza. Il 
SSP inserisce spazi in bianco al termine delle righe più corte delta lunghezza di 
record o tronca i record alla lunghezza specificata. 1 membri in un file nel modo 
a record, sono preceduti da una specifica COPY e sono seguiti da una specifica 
CEND. Vedere le Specifiche COPY e CEND per ulteriori informazioni su queste 
specifiche, 


JOBSTR esegue il programma di utilità $MAINT e può elaborare una specifica 
OCL.JOBO. 


JOBSTR nome file, [none procedura], SAVE slnome libreria 


NOSAVE libreria corrente 


Q 


, | AUTO 11}, | REWIND 


priorità coda lavori NOAUTO TI: LEAVE 


T2 UNLOAD 


nome file specifica il nome del file contenente uno o più membri di procedura o 
origine. 


nome procedura specifica la procedura da eseguire dopo che i membri sono co- 
piati. La procedura non è necessario che sia uno dei membri che devono es- 
sere copiati ma è necessario che sia nella stessa libreria dei membri copiati. 


SAVE indica che la procedura specificata da nome procedura deve rimanere nella 
libreria dopo l'esecuzione. Se non è specificato alcun parametro, si presume 
SAVE. 
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NOSAVE specifica che dopo l'esecuzione della procedura specificata da nome 


procedura questa va rimossa dalla libreria, 


nome libreria specifica la libreria in cui i membri devono essere copiati. Se non è 


specificato un nome di libreria, ‘si presume la libreria corrente. 


Q specifica che la procedura deve essere eseguita dalla coda di lavori ed ha una 


priorità di coda lavori di 3; vedere più avanti la descrizione di priorità coda 
lavori per una descrizione della priorità di coda lavori. Se non è specificato 
alcun parametro ma è specificato un nome di procedura, la procedura viene 


eseguita come parte del lavoro contenente la procedura JOBSTR, 


priorità coda lavori specifica la priorità di coda lavori per quel lavoro; cioè l'ordi- 


S1, 


ne di elaborazione del lavoro dalla coda. La priorità di coda lavori può essere 
qualsiasi numero decimale da 0 a 5, il sistema inizia ad eseguire i lavori in 
ordine decrescente di priorità di coda. Per esempio, tutti ì lavori con priorità 
di coda di lavori 5 sono eseguiti prima di qualsiasi altro lavoro nella coda. | 
lavori con la stessa priorità di coda lavori, vengono eseguiti con una priorità 
di coda lavori di 1 sono sono gli ultimi lavori eseguiti dal sistema. La priorità 
di coda lavori 0 è solitamente bloccata e cioè qualsiasi lavoro inserito sulla 
coda di lavori con la priorità di 0 non viene eseguito fino a che l'operatore 
di sistema non avvia la priorità 0. Se non viene specificato alcun parametro 
ma viene specificato un nome di procedura, la procedura viene eseguita come 
parte del lavoro contenente la procedura JOBSTR. 


S2 o S3 specifica l'alimentatore a minidischi contenente il primo minidisco 
dal quale i membri devono essere elaborati. Se non è specificato alcun 
parametro si presume S1. 


Mi1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidi- 


sco dal quale i membri devono essere elaborati. M1 indica il primo caricatore 
e M2 indica il secondo. nn è un numero decimale da 01 a 10 che identifica 
la locazione del minidisco nel caricatore. Specificare M1 equivale a specifica- 


re M1.01. Specificare M2 equivale a specificare M2.01. 


AUTO specifica quanto segue: 


e Se vengono specificati S1, S2 o $3, possono essere usati tutti e tre i sin- 
goli alimentatori {S1, S2 e S3). L'elaborazione inizia con il minidisco 
nell'alimentatore specificato’ e continua fino al minidisco nell’alimentato- 
re S3. Se occorrono altri minidischi, viene visualizzato un messaggio e 
l'operatore deve inserire i nuovi minidischi. L'elaborazione riprende col 
minidisco nell’'alimentatore S1. 


e Se viene specificato MI.nn o M2.nn, possono essere usati entrambi gli 
alimentatori del caricatore (M1 e M2). L'elaborazione inizia con il mini- 
disco nella locazione specificata e continua fino al, minidisco nella loca- 
zione M2.10. Se occorrono altri minidischi, viene visualizzato un messag- 
gio e l'operatore deve inserire i successivi caricatori. L'elaborazione 
riprende alla locazione M1.01 e continua fino a M2.10. 


e Se viene specificato T1 o T2, quando la bobina di nastro sull’unità na- 
stro originale è terminata, il sistema passa all'altra unità nastro, se dispo- 
nibile, per continuare i’elaborazione (da T1 a T2 o da T2 a T1). Se l’al- 
tra unità nastro non è disponibile, viene usata l’unità nastro originale. 


e  Seèspecificato TC, il parametro AUTO/ NOAUTO viene ignorato in quanto vi 
è soltanto l'unità nastro a cassetta. 


Se non è specificato alcun parametro, si presume AUTO. 


Can 


Voet 


NOAUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, è possibile soltanto usare l'alimentatore 
specificato. Se occorrono altri minidischi, viene visualizzato un messaggio 
e l'operatore deve inserire il successivo minidisco nell’afimentatore speci- 
ficato. 


e Se viene specificato M1.nn o M2.nn, può essere usato soltanto il carica- 
tore specificato. L'elaborazione inizia con il minidisco nella locazione 
specificata e continua fino all'ultimo minidisco nel caricatore. Se occor- 
rono altri minidischi, viene visualizzato un messaggio e l'operatore deve 
inserire il successivo caricatore nell’alimentatore del caricatore che viene 
usato. L'elaborazione riprende alla prima locazione nel caricatore, 


e Se viene specificato T1 o 72, per tutti i volumi di nastro verrà usata sol- 
tanto l’unità nastro specificata. 


e Seèspecificato TC, il parametro AUTO/ NOAUTO viene ignorato in quanto vi 
è soltanto l’unità nastro a cassetta. 


11 specifica che il file da copiare si trova su minidisco. 


T1,T20 TC specifica che il file da copiare si trova su nastro. T1 indica che il nastro 
è montato sull'unità nastro 1. T2 indica che il nastro è montato sull'unità na- 
stro 2. TC indica che il nastro è un nastro a cassetta. 


REWIND specifica che il nastro deve essere riavvolto dopo che è stata eseguita la 
procedura JOBSTR. Se questo parametro non viene specificato si presume 
REWIND. Questo parametro non è ammesso se è specificato F1 o 11. 


LEAVE specifica che il nastro deve essere lasciato dove si trova dopo che 
è stata eseguita la procedura JOBSTR. L'operazione che segue inizia da questo 
punto. Questo parametro non è ammesso se è specificato F1 o 11. 


UNLOAD specifica che il nastro deve essere riavvolto e scaricato dopo che è stata 
eseguita la procedura JOBSTR. Questo parametro non è ammesso se è speci- 
ficato F1 o l1. Se sono specificati UNLOAD e TC, il nastro verrà riavvolto dopo 
l'elaborazione. 
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Esempi 


Per i seguenti esempi, un file su minidisco contrassegnato JOBS contiene il se- 
seguente flusso di lavori: 


// COPY NAME-PROC1,LIBRARY-P,HIST-NO 
// LOAD PROGRAM 

// RUN 

// END 

/} CEND 

// COPY NAME-PROC2,LIBRARY-P 

// LOAD PROGRAM? 

// FILE NAME-FILEABC 

// RUN 

// END 

// CEND 

// COPY NAME-MEMBERI,LIBRARY-S 

THIS IS A SOURCE MEMBER 

This is the second line of the source member 
// CEND 


Esempio 1 


Copia dei membri di procedura (PROCI e PROC2) e del memore origine 
{MEMBERf1) nella libreria denominata MYLIB. 


JOBSTR JOBS,,,MYLIB 


Esempio 2 


Copia dei membri di procedura (PROC1 e PROC2) e del membro origine 
(MEMBERT1) nella libreria denominata MYLIB e quindi esecuzione di PROC1 
(PROCT1 deve essere salvato). 


JOBSTR JOBS,PROC1, ,MYLIB 
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| PROCEDURA KEYS 


La procedura KEYS è utilizzata per eseguire le seguenti funzioni: 


trebbe essere la mappa assegnata automaticamente dal DHCF (Distributed Host 
Command Facility) quando un utente si collega con il DHCF, o una mappa defi- 


© Visualizzare la mappa in uso corrente della tastiera 3270-a-5250; questa po- 
nita dall'utente. 


e Definire uninsieme differente di valori di tastiera per la tastiera 3270 quando 
questa è utilizzata da un utente 3270 su un sistema principale remoto in colle- 
gamento con un Sistema/36. 


e Scegliere una mappa di tastiera tra tutte quelle definite per un utente 3270. 
e Ripristinare la mappa di tastiera in uso con quella assunta fornita dal DHCF. 
La procedura KEYS può essere eseguita su una stazione video 3270 da qualsiasi 
utente di sistema remoto o utente di Sistema/36 (su un video 5250). Tutte le op- 


zioni listate possono essere eseguite da una stazione video 3270; solo l'opzione 
di definizione può essere eseguita da una stazione video 5250. 


NOTA: Prima di poter eseguire la procedura da una unità 3270 (o una unità che 
emula il 3270), il DHCF deve essere attivo sul Sistema/36; e l'utente deve essersi 
collegato con successo sul sistema principale HCF e sul Sistema/36. 


KEYS DHCF, | DISPLAY | nome membro,nome libreria 
DEFINE 


RESET 
SELECT 





DHCF specifica il tipo di tastiera da usarsi con il DHCF. Cioè, la tastiera e il video 
da usarsi come 5250 remoto è un video 3277, 3278 o 3279. DHCF, il valore 
assunto, è il solo consentito per questo parametro. 


DISPLAY specifica che deve essere presentata la mappa di tastiera in uso corrente 
per il video 3270. Se specificato, viene visualizzata la tastiera in uso corrente 
della stazione video 3270; potrebbe essere quella assunta automaticamente 
fornita dal DHCF o quella definita da un utente. L'opzione DISPLAY è valida 
solo su una stazione video 3270. 


nita e memorizzata in un membro origine o che un membro di mappa esistente 
deve essere preparato per la stampa. Solo membri creati originariamente dalla 
procedura KEYS possono essere preparati per fa stampa. Una nuova mappa 
può essere definita (o una mappa esistente ridefinita) sia da una stazione video 
3270 che da una stazione video 5250; ma può essere attivata soltanto da una 
stazione video 5250. 


SELECT specifica che una mappa di tastiera precedentemente definita, deve esse- 
re attivata come tastiera corrente per l'utilizzo in una sessione DHCF. La ta- 
stiera è scelta fra tutte quelle elencate quando la procedura KEYS specifica l'op- 
zione DISPLAY. L'opzione SELECT è valida soltanto per una stazione video 


DEFINE specifica che una nuova mappa di tastiera 3270-a-5250 deve essere defi- 
| 3270. 
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RESET specifica che la mappa di tastiera corrente definita dall'utente, deve essere 
sostituita da quella assunta automaticamente fornita dal DHCF. Questa opzio- 
ne è valida solo su un video 3270. 


nome membro specifica il nome del membro di tastiera da scegliere, definire o ride- 
finire. Questo parametro è necessario se è indicata l'opzione DEFINE o SELECT; 
non è valido se è specificata l'opzione DISPLAY o RESET. 


nome libreria specifica il nome della libreria contenente il membro di tastiera da sce- 
gliere, definire o ridefinire. Se con le opzioni DEFINE o SELECT questo parame- 
tro non è specificato, viene assunta la libreria in uso corrente. Questo parame- 
tro non è valido per le opzioni DISPLAY e RESET. 


Esempio 1 


Questo comando avvia la definizione di un membro di tastiera 3270 che deve esse- 
re denominato KEYS3279 e memorizzato nella libreria JONES. Questo comando 
può essere immesso da un utente del Sistema Principale o da un utente del 
Sistema/36. 


KEYS DHCF,DEFINE,KEYS3279,JONES 


Esempio 2 


Questo comando, immesso da una stazione video 3270, specifica che la mappa 
di tastiera 3270 definita dall'utente e denominata KEYS3279 deve essere attivata 
come mappa di tastiera in uso corrente per la sessione. Il nome del membro conte- 
nente la mappa dovrà essere localizzato nella libreria di sessione corrente (in que- 
sto caso JONES). 


KEYS,SELECT,KEYS3279 


KEYSORT 


PROCEDURA KEYSORT 


La procedura KEYSORT seleziona le chiavi per un file a indice su disco specificato. 
L'indice primario viene selezionato a meno che non si specifichi un indice alternati- 
vo per il file. La selezione delle chiavi non può essere eseguita dalla procedura KEY- 
SORT se qualche altro lavoro ha l'uso esclusivo del file le cioè se il lavoro non sta 
condividendo il file). Per ulteriori informazioni sulla condivisione dei file, vedere la 
Specifica OCL FILE (peri file su disco). Per ulteriori informazioni sulla selezione del- 
le chiavi indice, vedere il manuale Concepts and Programmer's Guide. 


La procedura KEYSORT esegue il programma di utilità $DDST, 


nome file, |mmggaa|,|J|,| NOCHKDUP 


ggmmaa T CHEDUP 
aammgg i 


nome file specifica il file a indice le cui chiavi devono essere selezionate. 


mmggaa, ggmmaa o aammgg specifica la data di creazione del file. La data speci- 
ficata deve essere nel formato della data della sessione; usare il comando 
STATUS SESSION per determinare il formato della data della sessione. Se 
non viene specificata una data, vengono selezionate le chiavi indice nel file 
con l'identificazione spefificata e con la data di creazione più recente, 


J o T specifica la ritenzione del file. Specificando J o T si definisce un file spe- 
cifico da elaborare. Quando non è specificata la ritenzione del file, l'ordine 
di ricerca inizia con J (file di lavoro) quindi T (file residente). Il KEYSORT 
viene eseguito sul primo file trovato col nome e la data specificati. (La pro- 
cedura KEYSORT seleziona soltanto le chiavi di un file). 


NOCHKDUP specifica che non deve essere eseguito alcun controllo per le chiavi 
doppie. Se non è specificato alcun parametro si presume NOCHKDUP. 


CHKDUP specifica che la procedura KEYSORT deve controllare le chiavi doppie 


nell'indice. Se si trova una chiave doppia, viene visualizzato un messaggio. 


Esempio 
Selezionare le chiavi indice in un file su disco a indice denominato PAYRCD. 


KEYSORT PAYRCD 
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PROCEDURA LIBRLIBR 


La procedura LIBRLIBR copia uno o più membri di libreria da una libreria ad un’altra. 
È possibile ridenominare i membri di libreria utilizzando la procedura CHNGEMEM. 


La procedura LIBRLIBR non può copiare membri di libreria forniti dalla IBM. 
Questi membri di libreria sono le procedure fornite dalla IBM, i membri origine 

. e i membri oggetto che vengono forniti con il SSP e con altri programmi su li 
cenza. È membri di libreria che non sono forniti dalla IBM sono membri di libre- 
ria creati dall'utente. ; 


La procedura LIBRLIBR esegue il programma di utilità $MAINT. 


LIBRLIBR nome libreria provenienza,|nome libreria arrivo s| SOURCE |, 
nome libreria provenienza| |(S) 
PROC 
(P) 
LOAD 
(0) 
SUBR 
(R) 
LIBRARY 





nome mebro » [nuovo nome membro] » [REPLACE] 
nome membro,ALL = . 
ALL 3 





nome libreria provenienza specifica la libreria dalla quale devono essere copiati 
uno o più membri di libreria, Se non viene specificato alcun nome di libreria, 
questo viene richiesto. 


nome libreria arrivo specifica la libreria su cui devono essere copiati uno o più 
membri. Se non è specificato alcun nome di libreria, si presume la libreria di 
provenienza. 


Nota: se i nomi della libreria di provenienza e della libreria di arrivo sono gli 
stessi, al membro che viene copiato deve essere attribuito un nuovo nome. 


SOURCE o S specifica che devono essere copiati soltanto i membri origine. Se 
non viene specificato alcun parametro, si presume SOURCE. 


PROC o P specifica che devono essere copiati soltanto i membri di procedura. 
LOAD o O specifica che devono essere copiati soltanto i membri oggetto. 
SUBR o R specifica che devono essere copiati soltanto i membri di sottoroutine. 


LIBRARY specifica che devono essere copiati tutti i tipi di membri (SOURCE, 
PROC, LOAD e SUBR). 


nome membro specifica il membro di libreria da copiare. RI 
> 
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nome membro,ALL specifica che devono essere copiati tutti i membri coi nomi 
che iniziano con i caratteri specificati dal nome membro. E’ possibile speci 
ficare fino a 7 caratteri per il nome membro. 


ALL specifica che tutti i membri devono essere copiati. ALL non è ammesso se 
from library e to library sono gli stessi. 


nuovo nome membro specifica i nuovi nomi dei membri copiati. ll nuovo nome 
deve essere specificato se libreria di provenienza e libreria di arrivo coincido- 
no. Se era specificato nome membro,ALL il nuovo nome dei membro deve 
contenere lo stesso numero di caratteri del nome de! membro, ! rimanenti 
caratteri in ciascun nome membro, non sono cambiati. 


Se non è specificato un nuovo nome membro, i nomi dei membri non sono 
cambiati. 


REPLACE specifica che se /a libreria di arrivo contiene un membro di libreria 
con lo stesso nome dei membro che viene copiato, il membro che viene 
copiato deve sostituire il membro esistente. 


Se non è specificato REPLACE, i membri vengono disposti nella libreria fino 
a che non si trova un membro con lo stesso nome di.quelio che viene copia- 
to. in questo caso, viene visualizzato un messaggio e l'operatore può conti- 
nuare l'elaborazione e sostituire il membro esistente oppure cancellare la pro- 
cedura. Se l'operatore continua l'elaborazione e vengono trovati altri duplicati, 
i membri esistenti vengono automaticamente sostituiti e non vengono visua- 
lizzati i messaggi per indicare i membri doppi. 


Esempio 1 


Copiare il membro origine denominato TEST da una libreria denominata MYLIB 
in una libreria denominata YOURLIB. 


LIBRLIBR MYLIB,YOURLIB, ,TEST 


Esempio 2 


Copiare tutti i membri di libreria denominati TEST da una libreria denominata 
YOURLIB e sostituire tutti i membri denominati TEST in YOIRLIB. 


LIBRLIBR MYLIB,YOURLIB,LIBRARY,TEST,,REPLACE 


Esempio 3 
Copiare tutte le procedure che iniziano con PAY da una libreria denominata 
TESTLIB a una libreria denominata PAYLIB. 1 membri che vengono copiati de- 
vono sostituire i membri di procedura esistenti in PAYLIB che iniziano con PAY. 


LIBRLIBR TESTLIB,PAYLIB,P,PAY,ALL,,REPLACE 
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n Pagina lasciata intenzionalmente bianca 


I 














PROCEDURE LINES 


66 


La procedura LINES cambia il numero di righe per pagina, la densità orizzontale 
di stampa (caratteri per pollice) e la densità verticale di stampa {righe per pollice) 
per l'emissione stampata da una sessione di unità video. Un lavoro inserito nella 
coda lavori usa i valori di righe per pagina e di caratteri per pollice che erano 
validi quando il lavoro è stato immesso sulla coda lavori. 


E’ inoltre possibile usare la procedura PRINT per modificare queste regolazioni, 
vedere la Procedura PRINT. 


La procedura LINES elabora una specifica OCL FORMS. 


righe per pagina , [caratteri per pollice|, [rigne per pollice | 





righe per pagina specifica il numero di righe per pagina. Il numero massimo di 
righe che può essere specificato è 112. Se non viene specificato alcun valore, 
si assume 66. La specifica di righe per pagina rimane valida fino a che la 
sessione termina oppure non viene specificato un nuovo valore di righe per 
pagina: 


e Da un'altra procedura LINES 

e Dalla procedura PRINT 

e Dalla specifica OCLi FORMS 

e Dalla specifica OCL PRINTER (solo per quel file di stampa) 


e Dalla procedura SET o dal programma di utilità $SETCF 


Per i programmi di utilità SSP, la stampatrice salta ad una nuova pagina 
quando arriva ad un numero di righe inferiore di 6 a quello specificato. Per 
esempio se è specificato 66, la stampatrice salta ad una nuova pagina dopo 
aver stampato la riga 60. Inoltre, la stampa inizia alla riga 6 della nuova 
pagina. Pertanto, se si specifica 66 in realtà si ottengono 54 (66 — 12 = 54) 
righe per pagine. Se viene specificato LINES 13 viene stampata una riga per 
pagina. Quando sono specificate 12 righe o meno, la stampa sì verifica su 
ogni riga di ciascuna pagina. 


Per fe operazioni di stampa dei programmi, il SSP indica una condizione di 
eccedenza quando sono stampate 6 righe meno dei numero di righe specifi- 
cato. a 


caratteri per pollice specifica la densità di stampa orizzontale (cioè i caratteri per 
pollice) da usare per l'emissione stampata dalla sessione di unità video, | va- 
lori che possono essere specificati sono 10 o 15. Là stampatrice da usare de- 
ve supportare la densità di stampa orizzontale specificata. Se il valore specifi- 
cato non è supportato dalla stampatrice, viene visualizzato un messaggio d’er- 
rore ed è possibile continuare o cancellare il lavoro. Se non viene specificato 
il valore di carattere per pollice, la densità di stampa orizzontale non viene 


cambiata. 
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It valore dei caratteri per pollice rimane valido fino a che la sessione termina 
o non viene specificato un altro valore: 


e Da un'altra procedura LINES 

e Dalla procedura PRINT 

e Dalla specifica OCL FORMS 

e Dalla specifica OCL PRINTER (per quel passo di stampa soltanto). 


Se era stata specificata l'opzione {0} per il valore caratteri per pollice quando 
la stampatrice è stata configurata, questo parametro viene ignorato. 


righe per pollice specifica la densità verticale di stampa (righe per pollice) da usa- 


re per l'emissione stampata dalla sessione di unità video. | valori che possono 
essere specificati sono 4, 6 e 8. Se l'emissione è stampata su una stampatrice 
che non supporta la densità verticale di stampa, il valore righe per pollice viene 
ignorato. 


II valore righe per pollice rimane valido fino a che la sessione termina o non 
viene specificato un nuovo valore righe per pollice: 


e Da un'altra procedura LINES 

e Dalla procedura PRINT 

e Dalla specifica OCL FORMS 

e Dalla specifica OCL PRINTER {per quel passo di stampa soltanto). 


Se non è specificato alcun valore di righe per pollice e questo non era pre- 
cedentemente impostato durante la sessione, il sistema usa il valore imposta- 
to durante la sessione, il sistema usa il valore impostato durante la configura- 
zione del terminale (4, 6 o 8). Se non è stato specificato alcun valore righe 
per pollice durante la configurazione del terminale, il sistema usa un valore 
di 6. 


Se era stata specificata l'opzione (0) per il valore righe per pollice quando la 
stampatrice è stata configurata, questo parametro viene ignorato. 


Esempio 1 


Cambiare il numero di righe per pagina a 33. 


LINES 33 


Esempio 2 


Questo esempio mostra come modificare le righe stampate per patina a 88, la 
densità di stampa orizzontale a 15 caratteri per pollice e la densità verticale di 
stampa a 8 righe per pollice. La carta da usare è lunga 11 pollici (28 cm) (11 x 8 
= 88 righe per pagina). 


LINES 88,15,8 


PROCEDURA LIST 


La procedura LIST consente di stampare e inoltre selezionare un file su disco 
usando il DFU. Le specifiche di file sono usate per definire il formato del record 
nel file. Per ulteriori informazioni su il DFU, vedere il manuale Fengranuna di 


Utilità per file di dati (DFU). 


nome file,nome programma dfu, [none membro origine file] 3 


NOSORT|, , |NN , none membro origine atu], 
YN 
YY 
GO 


Sos 
SORT z| |Nr 
|B 


[ nome file princ ipale| , nome libreria ,.| nome file su disco | 
libreria corrente 





nome file specifica il fite da stampare. Il nome file può contenere da 1 a 8 carat- 
teri alfanumerici. 


nome programma dfu specifica il programma DFU da usare per elaborare il file. 
Se il programma non esiste nella libreria, il DFU avvia le procedure di impo- 
stazione. Se il programma esiste nella libreria, it DFU va direttamente a lista- 
re il file. 


nome membro origine file specifica il membro origine contenente la descrizione 
del file (specifiche F) e le specifiche di immissione dei record (specifiche 1) 
che descrivono il file da elaborare. Questo membro può contenere una o più 
serie di descrizione file e di specifiche di immissione o un intero programma 
RPG Il. Le specifiche di descrizione di file e di immissione che corrispondo- 
no al file sono considerate come descrizione dei dati. 
Questo parametro è richiesto se non esiste la descrizione del formato speci- 
ficato. 


NOSORT specifica che il file non deve essere selezionato prima di venire stampa- 
to. Se non viene specificato alcun parametro, si presume NOSORT. 


SORT specifica che il file deve essere selezionato prima di venire stampato. 
D, Z o B indica se i campi numerici non a chiave devono essere riempiti con zeri 
{esadecimale F0) o con spazi in bianco. Le sole entrate ammesse sono D, Zz o 


B. Se non è specificato alcun parametro, sì presume D. 


D o B specifica un file di dati con riempimento di spazi vuoti dei SID. nu- 
merici senza chiave. 


Z specifica un file di dati con riempimento di zeri dei numerici senza chiave. 
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NN, NY, YN, YY, o GO indica come devono essere elaborate le specifiche origi- 
ne. Questo parametro a due caratteri viene usato se il programma DFU non 
esiste e deve essere eseguita l'impostazione del programma, Esso indica se le 
specifiche DFU per questo programma sono già memorizzate nella libreria 
e se.devono essere memorizzate ‘nella libreria al termine dell'impostazione, 
Questo membro origine delle specifihce DFU, è memorizzato o cercato nella 
libreria corrente, a meno che non sia specificato un nome di libreria. 


NN ie specifiche DFU memorizzate non sono usate per l'impostazione di 
questo programma. Viene richiesto di creare le specifiche ma queste non 
vengono salvate nella libreria. 


NY ie specifiche DFU memorizzate non sono usate per questa impostazione 
di programma. Viene richiesto di creare le specifiche; una volta create, le spe- 
cifiche sono memorizzate nella libreria. 


YN ie specifiche memorizzate DFU sono usate per l'impostazione di questo 
programma. Non è richiesto ma è possibile aggiornare le specifiche prima che 
venga creata la descrizione di formato. Se si modificano te specifiche sull’uni- 
tà video, viene interessato solatnto questo programma; le modifiche non sono 
memorizzate nella libreria. 


YY per questa impostazione di programma sono usate le specifiche DFU me- 
morizzate. Non è richiesto ma è possibile aggiornare le specifiche prima che 
venga creata la descrizione di formato. Le specifiche nella libreria sono sosti- 
tuite dalle specifiche aggiornate. 


GO per questa impostazione di programma sono usate le specifiche DFU me- 
morizzate. Non è richiesto e non è possibile aggiornare le specifiche prima 
che il programma venga creato, a meno che si trovino errori, Se si trovano 
errori nelle specifiche, occorre correggerle prima che il programma venga 


creato. In ogni caso, le specifiche DFU memorizzate non sono cambiate, 


nome mebro origne dfu specifica il membro origine che contiene o conterrà le 
specifiche DFU salvate. Questo parametro è richiesto se il parametro di 
elaborazione origine DFU non è NN. 


nome file principale specifica il file a indice che contiene le informazioni relative 
al file. Vedere il manuale Programma di Utilità per file di datì (DFU) per 
ulteriri informazioni su questo file. 


nome libreria specifica la libreria che contiene o che conterrà le specifiche DFU. 
Tutti i membri di libreria associati con il programma DFU sono cercati o me- 
morizzati in questa libreria. Se non viene specificato questo parametro, si 
presume la libreria corrente. 


nome file su disco specifica il nome del file nella VTOC del disco da visualizzare, 
se è diverso dal nome specificato nel programma DFU. Con questo parametro 
specificato, diversi programmi, che si riferiscono a differenti file logici, posso- 
no visualizzare lo stesso file su disco. È un parametro opzionale. 


Esempio 


Questo esempio mostra come stampare un file su disco denominato FILE1. Le 
specifiche origine DFU da usare per visualizzare i record sono denominate DFU- 
SETUP. Le specifiche sono nella libreria corrente. 


LIST FILEl,DFILIFMT,,,,GO,DFUSETUP 


PROCEDURA LISTDATA 


La procedura LISTDATA, elenca sull'unità di lista di sistema assegnata all'unità vi- 

| deo, l’intero file su disco, su minidisco, su nastro o nastro a cassetta, o una sua 
parte. Durante l'operazione di lista, ia procedura LISTDATA può omettere o inclu- 
dere specifici record. 


Per informazioni sull'assegnazione dell'unità di lista di sistema, vedere la Procedu- 
ra SYSLIST. Quando l’unità di lista del sistema è lo schermo video (CRT), le in- 
formazioni vengono visualizzate come se si fosse immesso il parametro CRT. 


La procedura LISTDATA può elaborare un file che viene usato da un altro lavo- 
ro sul sistema se la specifica FILE di quel lavoro indica DISP-SHRRR o DISP- 
SHRRM: vedere la Specifica OCL FILE (per i file su disco) per ulteriori informa- 
zioni sul parametro DISP. 


La procedura LISTDATA può essere usata per listare il contenuto di un file su disco 
su un sistema remoto. Vedere Distributed Data Management Guide. 


La procedura LISTDATA esegue il programma di utilità $COPY. 


LISTDATA nome file,|mmggaal|,|F1}|,{Sl s [AUTO |,| REWINDI ,| CHAR 
gemmaa| | Il| |S2 NOAUTO| | LEAVE HEX 
aammgg) | T1 53 UNLOAD| |PARTHEX 
a Te | Ml.nn CRT 

M2.nn 


NOREORG|, | INCLUDE , [posizione], EQ , [caratteri > [Lunghezza recorà], 
REORG OMIT NE al L_ 


LT 
LE 
GI 


Pali i 
STL: 


(num. massimo record] 





nome file specifica il file da listare. Il file può avere qualsiasi organizzazione di 
file. 


mmggaa, ggmmaa o aammdd specifica la data di creazione del file da listare. La 
data, se specificata deve essere nel formato della data della sessione; usare il 
comando STATUS SESSION per determinare il formato della data della ses- 
sione. Se non viene specificata una data, ed esiste più di un file con lo 
nome, viene listato il file creato più dì recente. 


F1 specifica che il file da listare è sul disco. Se non viene immesso alcun parame- 
tro, viene presunto F1. 


Vi specifica che il file da listare è sul minidisco. 
| T1,T20 TC specifica che il file che deve essere listato si trova su nastro. T1 indica 
che il nastro è montato sull'unità nastro 1. T2 indica che il nastro è montato 


| sull'unità nastro 2. TC indica che il nastro è un nastro a cassetta. 
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S1, S2 o S3 specifica l'alimentatore a minidischi contenente il primo minidisco 
dal quale i membri devono essere elaborati. Se non è specificato alcun para- 
metro si presume S1. 

| Il parametro 4 è invalido se il parametro 3.è T1, T2, TC 0 F1. 


M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidisco 

| del file da elaborare. M1 indica il primo caricatore; M2 indica il secondo. nn è 
un numero da 01 a 10 che identifica la locazione del minidisco nel caricatore. 

Specificare M1 equivale a specificare M1.01. specificare M2 equivale a speci- 

ficare M2.01. li parametro 4 è invalido se il parametro 3 è T1, T2, TC o F1. 


AUTO specifica quanto segue: 


e Se vengono specificati S1, S2 o S3, è possibile usare tytti e tre i singoli 
alimentatori {S1, S2 e S3). L'elaborazione inizia con il minidisco nell‘ali- 
mentatore specificato e continua fino al minidisco nell'alimentatore S3. 
Se occorrono altri minidischi, viene visualizzato un messaggio e l'opera- 
tore deve inserire i successivi minidischi. L'elaborazione riprende col mi- 
nidisco nell’alimentatore S1. 


e Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli 
alimentatori del caricatore (M1 e M2). L'elaborazione inizia con il mini- 
disco nella locazione specificata e continua fino al minidisco nella loca- 
zione M2.10. Se occorrono altri minidischi, viene visualizzato un messag- 
gio e l'operatore deve inserire i successivi caricatori. L'elaborazione ri- 
prende alla locazione M1.01. 


e Se viene specificato T1 o T2, quando la bobina di nastro sull'unità na- 
stro originale è terminata, il sistema passa all'altra unità nastro, se dispo- 
nibile, per continuare l'elaborazione (da T1 a T2 o da T2 a T1). Se l'al 
tra unità nastro non è disponibile, viene usata l’unità nastro originale. 


| Verrà inviata una richiesta per verificare se la bobina montata è quella giu- 
sta per continuare l'elaborazione. 


e  Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato in quan- 
| to vi è soltanto l’unità nastro a cassetta. 


Se non è specificato alcun parametro, si presume AUTO, 
NOAUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, può essere usato soltanto l'alimentatore 
specificato. Se occorrono altri minidischi, viene visualizzato un messaggio 
e l'operatore deve inserire il successivo minidisco nell'alimentatore speci- 
ficato. 


e Se viene specificato M1.nn o M2.nn, può essere usato soltanto il carica- 
tore specificato. L'elaborazione inizia con il minidisco nella locazione 
specificata e continua fino all'ultimo minidisco nel caricatore. Se occor- 
rono altri minidischi, viene visualizzato un messaggio e l'operatore deve 
inserire il successivo caricatore nell’alimentatore che viene usato. L’elabo- 
razione riprende alla prima locazione nel caricatore. 


e Se viene specificato T1 o T2, per tutti i volumi nastro verrà soltanto 
usata l’unità nastro indicata. 


e Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato in quan- 
to vi è soltanto l’unità nastro a cassetta. 
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REWIND specifica che il nastro o nastro a cassetta deve essere riavvolto dopo che 
è stata eseguita la procedura LISTDATA. Si presume REWIND se questo para- 
metro non viene specificato. 


LEAVE specifica che il nastro o nastro a cassetta deve essere lasciato dove si trova 
dopo che è stata eseguita la procedura LISTDATA. La prossima operazione ini- 


zia da questo punto. 


UNLOAD specifica che il nastro deve essere riavvolto e scaricato dopo che è stata 
. eseguita la procedura rain Se sono specificati UNLOAD e TC, il nastro 
verrà riavvolto dopo l'elaborazione. 

CHAR, PARTHEX, HEX o CRT specifica che i record devono essere listati sul- 
l'unità di lista corrente del sistema. Se l’unità di lista corrente del sistema è 
una stampatrice, questi parametri specificano anche come i record devono 
essere stampati. Se l’unità di lista corrente del sistema è l’unità video (CRT), 
i record sono visualizzati come se fosse stato specificato il parametro CRT; le 
specifiche CHAR, PARTHEX e HEX, sono ignorate in quanto la specifica 
CRT consente di selezionare queste funzioni usando i tasti di comando. È’ 
possibile usare il comando STATUS SESSION per determinare l’unità di lista 
corrente di sistema ed è possibile usare la procedura SYSLIST per modifi- 
carla. 


Normalmente vengono stampati 100*byte di ciascun record per riga. Per i file 
diretti e sequenziali, insieme a ciascun record viene stampato il numero di 
record relativo. Per i file a indice, viene stampata la chiave di indice insieme 
a ciascun record se viene specificato REORG; altrimenti, i record del file a 
indice vengono stampati come file diretti o sequenziali. 


CHAR specifica che se l'unità di lista corrente è una stampatrice, vengono 
stampati soltanto i caratteri stampabili nel record. Se non viene specificato 
alcun parametro, si presume CHAR. Qualsiasi carattere non stampabile viene 
stampato come spazio in bianco. Per esempio, il seguente record contiene un 
carattere non stampabile nella terza posizione: 


12 4567 


PARTHEX specifica che se l'unità corrente di lista di sistema è una stampa- 
trice, i caratteri stampabili vengono stampati e di quelli non stampabili ven- 
gono stampati soltanto le rappresentazioni esadecimali. Per esempio, il se- 
guente record contiene un carattere non stampabile nella terza posizione. Il 
valore di quel carattere è esadecimale FA: 


12 4567 
F 
A 


HEX specifica che se l’unità corrente di lista del sistema è una stampatrice, i 
caratteri stampabili sono stampati e vengono stampate le rappresentazioni 
esadecimali di tutti i caratteri. Per esempio, il seguente record contiene un 
carattere non stampabile nella terza posizione, {| valore di quel carattere è 
esadecimale FA: 


12 4567 
FFFFFFF 
12Ak4567 


CRT specifica che (qualunque sia l’unità di lista corrente del sistema), i 
record devono essere visualizzati sull'unità video. Se viene specificato CRT 
per una lavoro inserito sulla coda lavori, i record sono listati sulla stampatri- 
ce di sessione. 


1 record possono essere visualizzati in formato alfanumerico e in formato 
esadecimale. 
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REORG specifica che se il file che deve essere listato è un file a indice, i record devono 


essere listati sequenzialmente per chiave. (I record cancellati non sono listati 
indipendentemente dal parametro REORG o NOREORG). Se si specifica REORG, 
il sistema visualizza o stampa la chiave sopra ciascun record. Chiavi non conti- 
gue vengono riunite prima di essere stampate. Se la chiave è visualizzata il si- 
stema la tronca dopo 70 caratteri. Una chidve esadecimale viene troncata dopo 
120 caratteri. 


NOREORG specifica che i record nel file devono essere listati nella posizione in 


cui si incontrano nel file. (1 record cancellati non sono listati indipendente- 
mente dal parametro REORG o NOREORG). 


INCLUDE o OMIT specifica se i record specifici nel file devono essere inclusi o omessi 


dalla fista. | parametri INCLUDE e OMIT lavorano con le posizioni EQ, NE, LT, 
GT, LE, GE e parametri ‘’carattere’’. Se è specificato soltanto ‘‘carattere’’ o 
posizione, viene assunto INCLUDE e EQ. 


posizione specifica per ciascun record il primo carattere da confrontare con i ca- 


EO 


NE 


LT 


LE 


GT 


GE 


ratteri di confronto. Posizione può essere qualsiasi numero da 1 a 4096. Se 
non è specificata uma posizione, ogni posizione nel record viene confrontata 
con i caratteri di confronto fino a che la condizione non è soddisfatta. 


specifica che se i caratteri nel record indicato da posizione, sono gli stessi dei 
caratteri di confronto, il record deve essere incluso o omesso della lista. 


Se viene specificato soltanto ‘caratteri’ o posizione, si presumono INCLUDE 
e EQ. 


specifica che se i caratteri nel record indicato da posizione non sono gli stessi 
dei caratteri di confronto, il record deve essere incluso o omesso dalla lista. 


specifica che se i caratteri nel record indicati da posizione sono minori dei ca- 
ratteri di confronto, il record deve essere incluso o omesso dalla lista. 


specifica che se i caratteri nel record indicati da posizione sono minori di o 
uguali ai caratteri di confronto, il record deve essere incluso o omesso dalla 
lista, 


specifica che se i caratteri nel record indicato da posizione sono maggiori dei 
caratterî di confronto, il record deve essere incluso o omesso dalla lista. 


specifica che se i caratteri nel record indicati da posizione sono maggiori o 
uguali ai caratteri di confronto, il record deve essere incluso o omesso dalla 
lista. 


‘caratteri’ specifica i caratteri di confronto, E’ possibile specificare fino a 30 ca- 


ratteri che devono essere racchiusi tra apici (‘). E’ possibile includere spazi in 
bianco e virgole {,) ma gli apici non possono essere inclusi come dati. 


lunghezza record specifica la lunghezza dei record listati e può trattarsi di qualsia- 


si numero da 1 a 4096. Se questo parametro non viene immesso, viene lista- 
to l'intero record. Questo parametro consente di listare soltanto una porzio- 
ne dei record nel file. 


Se la lunghezza record del file da listare è minore della lunghezza del record 
specificato, le nosizioni addizionali dei record nella lista sono riempite con 
spazi in bianco. Se la lunghezza di record del file da listare è maggiore della 
lunghezza di record specificata, le posizioni extra nel file sono troncate 
quando il file viene listato. 


num. massimo record specifica il numero totale di record da listare quando non 
si desidera listare l’intero record. E' possibile immettere qualsiasi numero 
maggiore di 0. Questo parametro è ignorato quando le entrate vengono visua- 


lizzate su una unità video. 


Esempio 1 
Stampa dei soli caratteri stampabili in tutti i record del file denominato FILE1. 


LISTDATA FILEl,,Fl 


Esempio 2 


Visualizzazione di tutti i record ne! file denominato FILE2 indipendentemente 
dall'unità di lista corrente di sistema. 


LISTDATA FILE2,,,,s CRT 


Esempio 3 
Stampa di tutti i record nel file su minidisco denominato FILE1. Devono essere 
stampati sia i caratteri nei record che le loro rappresentazioni esadecimali. Il mi- 


nidisco è nell'alimentatore 1. 


LISTDATA FILEl,,Il1,51 , NOAUTO s s HEX 


Esempio 4 


Stampa dei soli record nel file su disco denominato FILE3 che hanno il carattere 
X nella posizione 5 del record. Devono essere stampati soltanto i caratteri stam- 
pabili nei record. 


LISTDATA FILE3,,,,,,,,INCLUDE,5,EQ,'X' 


Esempio 5 


Visualizzare un file denominato FILE4 dalla bobina di nastro montata suli’unità 
nastro T1. Quando la visualizzazione è terminata, la bobina di nastro deve essere 
riavvolta all’inizio del nastro. 


LISTDATA FILEl,,T1,,,REWIND,CRT 


| Esempio 6 


Visualizza il contenuto di un file su nastro a cassetta denominato DATA1, sul- 
l’unità di stampa del Sistema. 


| LISTDATA DATAI,,TC 
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PROCEDURA LISTFILE 


La procedura LISTFILE elenca i contenuti di un file specificato di una libreria, 0 di 
un membro di cartella sull’unità di lista di sistema assegnata all'unità video richie- 
dente. Per informazioni sull’assegnazione dell'unità di lista di sistema, vedere la Pro- 
cedura SYSLIST. 


La procedura LISTFILE esegue il programma di utilità $BICR, $COPY o 
$MAINT in relazione ai parametri immessi. 


ggmmaa | |I1} |EXCHANGE| |S2 NOAUT DETAI 
aammgg TI IFORMAT 53 
T2| |LIBRARY | {Ml.nn 
LIBRFILE | |M2.nn 
SAVELIBR 


LISTFILE nomefile, |mmggaa |,|F1}),|{COPYFILE |,|Sl È: TE il 
O L 


STDLABEL |, fia volume |, FIXED i frunghezza record | ’ 
(SL) (F) 

NONLABEL FIXEDBLK 

(NL) (FB) 

NONSTAND VARIABLE 

(NS) (V) 

BYPASS 

(BPL) 


runghezza blocco] , {REWIND |, [numero sequenza | 
LEAVE 
UNLOAD 


nome file specifica il file da listare. 


mmggaa, ggmmaa o aammgg specifica la data di creazione del file da listare. Per 
un file su disco, la data specificata deve essere nello stesso formato della data 
della sessione. Se non è specificata la data di creazione per un file su disco 
ed esiste più di un file su disco con lo stesso nome file specificato, viene as- 
sunto il file con la data di creazione più recente. 


Per un file su minidisco, su nastro o nastro a cassetta, la data specificata deve 
essere nello stesso formato della data di creazione del file su minidisco, su na- 
stro o nastro a cassetta. Se la data di creazione per un file su minidisco, su 
nastro o nastro a cassetta non viene indicata ed esiste più di un file con lo stesso 
nome, viene elaborato il primo file nella VTOC del minidisco o nel nastro. 


F1 specifica che deve essere listato un file su disco, Se non è specificato alcun 
parametro e viene specificato per contro LIBRARY, LIBRFILE o COPY- 
FILE, si presume F1. 


11 specifica che deve essere listato un file su minidisco. Se non è specificato alcun 
I parametro e viene specificato per contro ARCHIVE, EXCHANGE, IFORMAT e 
SAVELIBR, si presume I1. 


| T1, T2 0 TC specifica che deve essere listato un file su nastro. T1 indica che il na- 
stro è montato sull'unità nastro 1. T2 indica indica che il nastro è montato sul- 
l’unità nastro 2. TC indica che il nastro è un nastro a cassetta. 


COPYFILE specifica che deve essere listato un file di dati su disco, su minidisco, 
su nastro o nastro a cassetta. Il file deve essere stato creato dal programma 
di utilità $COPY (la procedura SAVE). Se non viene specificato alcun parame- 
tro, si presume COPYFILE. 


EXCHANGE specifica che deve essere listato un file su minidisco o su nastro in for- 
mato base di interscambio. Vedere la Procedura TRANSFER per informazioni 
sul file in formato base di interscambio. Se viene specificato EXCHANGE, F1 
e TC non sono ammessi. 


IFORMAT specifica che deve essere listato un file su minidisco in formato di in- 
terscambio di tipo |. Vedere la Procedura TRANSFER per informazioni sui 
file in formato di interscambio di tipo I. Se viene specificato IFORMAT, F1, 
T1, T2 e TC non sono ammessi. 


LIBRARY specifica che deve essere listata una libreria su disco. ll nome file spe- 
cifica il nome della libreria. La lista è nello stesso formato di quella prodotta 
dalla seguente procedura LISTLIBR: 


LISTLIBR DIR,LIBRARY,nome file 


Se viene specificato LIBRARY, 11, T1, T2 e TC non sono ammessi. 


LIBRFILE specifica che deve essere listato un file su disco, su minidisco e su nastro 
o nastro a cassetta, creato dalla procedura FROMLIBR. Il file può contenere 
uno o più membri di libreria. Se il file era stato creato con formato modo re- 
cord, i membri sono membri origine e di libreria. 


La lista è identica a quella prodotta dalla procedura LISTLIBR. Vedere la 
Procedura LISTLIBR per ulteriori informazioni. 


SAVELIBA specifica che deve essere listata una libreria che è stata salvata su mini- 
disco, su nastro o nastro a cassetta con la procedura di SAVELIBR. Se è speci- 
ficato SAVELIBR, F1 non è ammesso. 


ARCHIVE specifica che deve essere listato un membro di cartella che è su minidi- 
sco, nastro o nastro a cassetta. Se è specificato ARCHIVE, F1 non è consenti- 
to. 


S1, S2 0 S3 specifica l'alimentatore a minidischi contenente il primo minidisco dal 
quale deve essere elaborato il file. Se non è specificato alcun parametro, si pre- 
sume S1. Questo parametro è invalido se viene specificato F1, T1, T2 o TC. 


M1.nn o MZ2.nn specifica la locazione del caricatore contenente il primo minidisco 
dal quale deve essere elaborato il file. Mi indica il primo caricatore e M2 indica 
il secondo. nn è un numero da 01 a 10 che identifica ia locazione del minidisco 
nel caricatore. Specificare M1 equivale a specificare M1.01. Specificare M2 
equivale a specificare M2.01. Questo parametro è invalido se viene specificato 
F1,T1,T20 TC. 
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AUTO specifica quanto segue: 


é Se viene specificato S1, S2 o S3, è possibile usare tutti e tre i singoli 
alimentatori (S1, S2 o S3). L'elaborazione inizia con il minidisco nell’a- 
limentatore S3. Se occorrono altri minidischi, viene visualizzato un mes- 
saggio e l'operatore deve inserire i successivi minidischi. L'elaborazione 
riprende col minidisco nell'alimentatore S1. 


e Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli 


alimentatori del caricatore (M1 e M2). L'elaborazione inizia con il mini- 
disco nella locazione specificata e continua fino al minidisco nella loca- 
zione M2.10. Se occorrono altri minidischi, viene visualizzato un messag- 
gio e l'operatore deve inserire i successivi caricatori. L'elaborazione ri- 
prende alla locazione M1,01. 


e Sevienespecificato T1 o T2, quando ta bobina di nastro sull'unità nastro 
originale è terminata , il sistema passa all'altra unità nastro, se disponibile, 
per continuare l'elaborazione (da T1 a T2 o da T2 a T1). Se l’altra unità 
nastro non è disponibile, viene usata l’unità nastro originale. Verrà eviden- 
ziata una richiesta per verificare l'esattezza della bobina montata. 


e  Seè specificato TC. il parametro AUTO/NOAUTO viene ignorato in quan- 
to vi è soltanto l’unità nastro a cassetta. 


Se non è specificato alcun parametro, si assume AUTO. 


NOAUTO specifica quanto segue: 


s Se viene specificato ST, S2 o S3, può essere usato-soltanto l'alimentatore 
specificato. Se occorrono altri minidischi, viene visualizzato un messaggio 
e l'operatore deve inserire il successivo minidisco nell'alimentatore speci- 
ficato. RE 


e Se viene specificato M1.nn o M2.nn, può essere usato soltanto il carica- 
tore specificato. L'elaborazione inizia con il minidisco nella locazione 
specificata e continua fino all'ultimo minidisco nel caricatore. Se occor- 
rono altri minidischi, viene visualizzato un messaggio e l'operatore deve 
inserire il successivo caricatore nell’alimentatore di caricatore d'uso. 
L'elaborazione riprende alla prima locazione nel caricatore. 


e Se è specificato T1 o T2, verrà usata soltanto l’unità nastro specificata 
per tutti i volumi nastro, 


e Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato in quan- 
to vi è soltanto l’unità nastro a cassetta. 


USER o DETAIL specifica il tipo di jinformazione da listare a proposito di cia- 


scun membro. USER specifica informazioni generali relative at membro; 
DETAIL specifica informazioni più dettagliate relative al membro. Se non 
viene specificato alcun parametro, si presume USER. Questo parametro è am- 
messo soltanto quando viene specificato LIBRARY, LIBRFILE o SAVE- 
LIBR. Per ulteriori informazioni sulle informazioni listate dai parametri 
USER e DETAIL, vedere la Procedura LISTLIBR. 


STDLABEL o SL specifica che il nastro o nastro a cassetta da elaborare ha delle 


identificazioni standard e tutte le informazioni necessarie per elaborare il file 
possono essere ricavate dall’identificazione del file su nastro. Se questo para- 
metro non viene specificato, si presume STDLABEL. Se nel parametro 3 è spe- 
cificato TC, questo parametro deve essere lasciato in bianco o deve contenere 
STDLABEL (SL). 


NONLABEL o NL specifica che il nastro da elaborare non ha alcuna identificazione e 
che occorre fornire tutte le informazioni necessarie per elaborare il file. Se nel 
parametro 3 è specificato TC, NONLABEL (NL) non è consentito. 


NONSTAND o NS specifica che il nastro da elaborare ha delle identificazioni non 
standard e che occorre fornire tutte le informazioni necessarie per elaborare il 
nastro. Se nel parametro 3 è specificato TC, NONSTAND (SL) non è consenti- 
to. 


BYPASS o BLP specifica che il nastro da elaborare ha delle identificazioni standard e 
che l'elaborazione dell'identificazione deve essere saltata. Devono essere for- 
nite tutte le informazioni necessarie per l'elaborazione del file. Se nel parametro 
3 è specificato TC, BYPASS (BLP) non è consentito. 


ID volume specifica l'identificazione di volume del nastro o nastro a cassetta da ela- 
borare e può contenere da 1 a 6 caratteri alfanumerici. È usato per controllare 
che sia montato il volume di nastro corretto. Se non è montato il nastro corret- 
to, viene emesso un messaggio di errore. È possibile continuare ad elaborare 
il file oppure riprovarlo dopo aver montato il nastro corretto, oppure cancellare 
l'operazione. Questo parametro non è ammesso se sono specificati NONLA- 
BEL, NONSTAND o BYPASS. Se viene listato un nastro multivolume, viene con- 
trollato soltanto i'ID di volume del primo nastro. 


FIXED o F indica che il tracciato del file da elaborare è a record non bloccati di lun- 
ghezza fissa. Se il tracciato di record non è indicato e viene invece specificato 
EXCHANGE, si presume FIXED. Se è specificato TC, FIXED (F) non è consenti- 
to. 


FIXEDBLK o FB specifica che il tracciato del file da elaborare è a record bloccati di 
lunghezza fissa. Se non è specificato il tracciato record ed il file è di tipo COPY- 
FILE, LIBRFILE o SAVELIBR, si presume FIXEDBLK. Se è specificato TC, questo 
parametro o deve essere lasciato in bianco 0 deve contenefe FB. 


VARIABLE o V specifica che il tracciato del file da elaborare è a record sbloccati di 
lunghezza variabile. Se è specificato TC, VARIABLE (V) non è consentito. 


Nota: Se il tipo di elaborazione è STDLABEL ed il tracciato record specificato (o 
quello che viene assunto per difetto) non corrisponde al tracciato record 
nell’identificazione del file su nastro, viene emesso un messaggio di errore. 


lunghezza record specifica il numero dei byte in un record logico su nastro o nastro 
a cassetta. Per i record di lunghezza variabile, questa è la lunghezza massima. 
Il valore specificato può contenere da 18 a 4096 byte. Il parametro lunghezza 
record è richiesto se viene specificato NONLABEL, NONSTAND o BYPASS. Se 
viene specificato STDLABEL e non viene specificata la lunghezza record, que- 
sta viene ricavata dall’identificazione del file su nastro o nastro a cassetta. Se 
vengono specificati sia la lunghezza record che STDLABEL, ia lunghezza re- 
cord specificata deve essere identica a quella deil’identificazione del file su na- 
stro o nastro a cassetta. Con un file tipo COPYFILE, LIBRFILE o SAVELIBR, se 
la lunghezza record è specificata, deve essere 256, 


lunghezza blocco specifica il numero di byte in un blocco fisico di dati del file su 
nastro o nastro a cassetta. Il valore specificato può contenere da 18 a 32.767 
byte. Questo parametro è indispensabile se era stato specificato FIXEDBLK, 
NONLABEL, NONSTAND o BYPASS, Se sono specificati FIXEDBLK e STDLA- 
BEL e la lunghezza di blocco non è indicata, quest’ultima viene ricavata dall'i- 
dentificazione del file su nastro o nastro a cassetta. Se la lunghezza blocco è 
indicata e sono specificati sia FIXEDBLK che STDLABEL, ia lunghezza blocco 
deve essere identica a quelia dell’identificazione del file su nastro o nastro a 
cassetta. Questo parametro è ignorato se viene specificato FIXED o VARIA- 
BLE. Con un file tipo COPYFILE o SAVELIBR, se questo parametro è specifica- 
to, deve essere 24576. Con un file LIBRFILE 4096. 
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REWIND specifica che il nastro o nastro a cassetta deve essere riavvolto dopo che 
è stata eseguita la procedura LISTFILE. Se questo parametro non viene speci- 
ficato, si presume REWIND. 


LEAVE specifica che il nastro o nastro a cassetta deve essere lasciato dove si trova 
dopo che è stata eseguita la procedura LISTFILE. L'operazione successiva ini- 


zia da questa posizione. 


UNLOAD specifica che il nastro deve essere riavvolto e scaricato dopo che è stata 
eseguita la procedura LISTFILE. Se è specificato UNLOAD e TC, il nastro verrà 
riavvolto dopo l'elaborazione. 


numero sequenza indica quale file deve essere elaborato in base alla posizione oc- 
cupata sul nastro. E’ possibile indicare un numero compreso tra 1 e 9999. Se 
questo parametro viene omesso e vengono specificati NONLABEL, NON. 
STAND o BYPASS, si presume un numero di sequenza di 1. Se questo para- 
metro è omesso e viene specificato STDLABEL, il file sarà individuato dalla 
sua identificazione di file. Se è specificato un numero di sequenza e viene 
specificato anche SDTLABEL, il file viene ricercato dapprima per numero di 
sequenza e quindi viene controllata l’identificazione di file. Se non si tratta 
del file corretto, il file viene individuato dalla sua identificazione di file. 


Esempio 1 


Lista del contenuto di un file su disco denominato PAY. 


LISTFILE PAY,,Fl 


Esempio 2 


Lista dei membri di una libreria denominata MY LIB salvata su minidisco, 


LISTFILE MYLIB,,Il,SAVELIBR 


Esempio 3 


Lista di un file denominato FILEA che contiene parecchi membri di libreria. 


LISTFILE MYLIB,,Il,LIBRFILE 


Esempio 4 


Listare sul nastro il file di interscambio denominato EXFILE. Il nastro era di ti- 
po senza identificazione. ll tracciato de! file era a record sbloccati di lunghezza 
variabile. li file era il terzo sul nastro. Dopo aver listato il file, lasciare il nastro 
nei punto in cui è terminata l'elaborazione. 


LISTFILE EXFILE,,T1,EXCHANGE, ,», NL, ,V,132,1320,LEAVE,3 


| Esempio 5 


| 


Lista di un file tipo SAVELIBR denominato MYLIB su un nastro a cassetta. Il file era 
stato salvato con la procedura SAVELIBR. 


LISTFILE MYLIB,,TC,SAVELIBR 


PROCEDURA LISTLIBR 


La procedura LISTLIBR lista i contenuti di una libreria. E' possibile listare quan- 
to segue: 


e Informazioni di stato relative ad una libreria, Per esempio, la dimensione del- 
la libreria, la dimensione dell’indirizzario, quanti minidischi sono richiesti per 
salvare la libreria (usando la procedura SAVELIBR). 


e | membri contenuti nella libreria (le entrate di indirizzario). 
e | contenuti dei singoli membri di libreria. 


e Le informazioni di indirizzario dei membri per nome, nome parziale o sot- 
totipo. LA 


La lista viene visualizzata o stampata sull'unità di lista del sistema. Per informa- 
zioni sull’assegnazione dell'unità di lista del sistema, vedere la Procedura PRINT . 
o la Procedura SYSLIST. 


La procedura LISTLIBR non lista membri di libreria forniti dalla IBM. Questi 
membri di libreria sono le procedure, i membri origine e membri oggetto che ven- 
gono forniti con il SSP o con altri programmi su licenza (ad esempio BASIC o 
RPG). | membri di libreria che non sono forniti dalla IBM, sono quelli creati 
dall'utente. Per listare i membri forniti dalla IBM, vedere Specifiche di procedura 
LISTLIBR: Programma di utilità $MAINT. 


La procedura LISTLIBR esegue il programma di utilità $MAINT. 
Per listare i nomi di ciascun membro e altre informazioni (le entrate di indiriz- 
zario): 


LISTLIBR DIR, SOURCE | ,|nome libreria .s | USER n [sottotipo ] 
libreria corrente DETAIL 


(S) 
PROC 
(P) 
LOAD 
(0) 
SUBR 
(R) 
LIBRARY 
ee 
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Per listare uno o più membri di libreria e le rispettive entrate di indirizzario: 











LISTLIBR | nome membro , SOURCE |,lnome libreria 
nome membro JALLf |(S) libreria corrente 
ALL PROC 
(P) 
LOAD: 
(0) 
SUBR 
(R) 
LIBRARY 
[sottotipo] ; | wewerrs] 
Per listare le informazioni di indirizzario per nome, per nome parziale o sottotipo: 
LISTLIBR | nome membro , |sourca , nome libreria ,|USER |,|NOPAGE|, 
nome membro,ALL\ |(S) libreria corrente| |DETAIL| |PAGE 
ALL PROC A 
(P) SA 
LOAD 
(0) 
SUBR 
(R) 
| BIBRARY 
[ sottotipo] » [p1RINFO | 
N 
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Per listare soltanto le informazioni di stato relative ad una libreria: 


Vagie 


LISTLIBR DIR,SYSTEM,|nome libreria 


libreria corrente 


DIR specifica che devono essere listate le informazioni di stato di libreria (se il 
secondo parametro è LIBRARY o SYSTEM) e le entrate di-indirizzario (se il 
secondo parametro non è SYSTEM). 


nome membro specifica il membro di libreria da listare. 


nome membro,ALL specifica che devono essere listati i contenuti dei membri di 
libreria i cui nomi iniziano con i caratteri specificati (nome membro). E’ pos- 
sibile specificare fino a 7 caratteri per il nome membro. 


ALL specifica che tutti i membri devono essere listati. 


SOURCE o $ specifica che soltanto i membri origine di libreria o le entrate di 
indirizzario devono essere listate. Se non viene specificato alcun parametro, si 
presume SOURCE. 


PROC o P specifica che devono essere listati soltanto i membri di ‘procedura di li- 
breria o le entrate di indirizzario. 


LOAD o O specifica che devono essere listati soltanto i membri oggetto di libre- 
ria e le entrate di indirizzario. 


SUBR o R specifica che devono essere listati soltanto i membri di sottoroutine di 
TS libreria o le entrate di indirizzario. 


LIBRARY specifica che devono essere listati tutti ì tipi di membri di libreria 
(SOURCE, PROC, LOAD e SUBR). 


SYSTEM specifica che devono essere listate soltanto le informazioni di stato per 
una libreria. Non vengono listati i nomi di membri di libreria. SYSTEM è 
valido soltanto con DIR. 


nome libreria specifica la libreria contenente i membri da listare, Se non è speci- 
ficato un nome di libreria, si presume la libreria corrente. 


USER o DETAIL specifica il tipo di informazione da listare a proposito di cia- 
scun membro. USER specifica informazioni generali relative al membro; 
DETAIL specifica informazioni più dettagliate. Se non è specificato alcun 
parametro, si presume USER. Per gli esempi dei due tipi di liste, vedere 
la Fig. 19 e la Fig. 20. 


NOPAGE o PAGE specifica, solo per i membri di procedura e i membri origine, 
se ciascun membro deve essere listato su una pagina separata. Se non viene 
specificato alcun parametro, si presume NOPAGE. | membri oggetto e di sot- 
toroutine sono sempre listati su pagine separate, 


NOPAGE specifica che devono èssere listati tanti membri per pagina quanti 
ne può accogliere una pagina. E' possibile usare questa opzione per rispar- 
miare carta sulla stampatrice, Vedere la Fig. 21 per un esempio di questa li- 
sta. 


PAGE specifica che ciascun membro deve essere listato su una pagina sepa- 


cn rata. 
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sottotipo specifica che i membri che vengono listati devono essere del sottotipo 
specificato. | sottotipi validi sono: 


ARP 
ARS 
ASM 
BAP 
BAS 
BGC 
BGD 


BGF. 


cCOB 
CMS 
CSP 
DLS 
DFU 
DTA 
FMT 
FOR 
ICF 


KEY 
MNU 
MSG 
PHL 
ODE 
ORY 
RPG 
SRT 
SSP 
TXT 
UNS 
WSU 
xX25 


Membro auto report RPG 

Membro a risposta automatica 

Membro assembler 

Procedura BASIC (membro origine) 
Membro BASIC 

Diagramma per la grafica 

Dati grafici gestionali 

Tracciato grafici gestionali 

Membro COBOL 

Membro comunicazioni e gestione sistema 
Membro prodotto sistema - incrociato 
Membro servizi documenti libreria 
Membro utilità file dati 

Membro dati 

Membro tracciato video 

Membro FORTRAN 

Membro Dispositivo Interattivo per le Comunicazioni procedura 
CNFIGICF 

Procedura KEYS 

Membro menù 

Membro messaggi 

Membro elenco telefonico 

Membro immissione Query 

Membro Query 

Membro RPG 

Membro Sort 

Membro di configurazione sistema procedura CNFIGSSP 
Membro testo 

Non specificato 

Membro utilità terminale 

Controllo collegamento commutazione a pacchetti X,25 


MEMBERS specifica che saranno listati i contenuti effettivi dei membri specificati. 
MEMBERS è il valore assoluto. 


DIRINFO indica che saranno listate soltanto le informazioni di indirizzario per i membri 
specificati. Specificare DIRINFO senza un nome membro è come specificare DIR 
nel primo parametro. 


Esempio 1 
Lista del membro di procedura PAYROLL nella libreria denominata MYLIB. 


LISTLIBR PAYROLL,PROC,MYLIB 


Esempio 2 


Lista di tutti i membri di libreria che hanno i nomi che iniziano con PAY nella 
libreria denominata PAYLIB. 


LISTLIBR PAY,ALL,LIBRARY,PAYLIB 


Esempio 3 


Lista nella libreria di sistema delle informazioni di stato e di tutte le entrate di. 


indirizzario della libreria per i membri non forniti dalla IBM. 


LISTLIBR DIR,LIBRARY, #LIBRARY 


Esempio 4 


Listare soltanto fe informazioni di indirizzario per tutti i tipi di membri di li- 
breria che iniziano con PAY presenti in una libreria denominata PAYLIB. 


LISTLIBR PAY,ALL,LIBRARY,PAYLIB,,,,DIRINFO 


Esempio 5 


Listare tutti i membri di una libreria denominata PAYLIB che sono del sottotipo 
COR. 


LISTLIBR ALL,LIBRARY,PAYLIB,,,COB 
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Liste campione LISTLIBR 


Quanto segue mostra liste campione di libreria. Dopo le liste campione c'è una 













descrizione delle voci delle liste stesse. FTS 
LIBRERIA- TEMLIB STATO DATA 12/09/83 ORA 11.50 
; 50 

AMPIEZZA IN BLOCCHI DELLA LIBRERIA 50 
AMPIEZZA IN SETTORI DELL'INDIRIZZARIO 10 Il numero dei blocchi 
SENTORI DISPONTATLI PER TERRE" STO disponibil a/dato.da 
VOCI USATE DELL' INDIRIZZARIO 3 Questa linsa:divisa 
VOCI DISPONIBILI IN INDIRIZZARIO 10 per dieci. 
AMPIEZZA IN BLOCCHI DELL'ESTENSIONE DELLA LIBRERIA 
SETTORI USATI DELL'ESTENSIONE 484 
SETTORI DISPONIBILI IN ESTENSIONE 
PRIMO SETTORE DELLA LIBRERIA (HEX) o , î 
ULTIMO SETTORE DELLA LIBRERIA (HEX) 14582C ueste liste compaiono 
PRIMO SETTORE DELL'INDIRIZZARIO (HEX) 145934 soltanto quando la 
ULTIMO SETTORE DELL'INDIRIZZARIO (HEX) 145942 libreria ha un'estensione 
PRIMO SETTORE DEI MEMBRI DI LIBRERIA (HEX) 145943 
ULTIMO SETTORE DEI MEMBRI DI LIBRERIA (HEX) 
SUCCESSIVO SETTORE DISPONIBILE PER I MEMBRI (HEX) 
PRIMO SETTORE: DELL'ESTENSIONE 
NUMERO MINIDISCHI RICHIESTI PER SALVARE LIBRERIA- 

TIPO 1 FORMAT (128) 2 

TIPO 1 FORMAT? (512) 1 

TIPO 2D FORMAT (256) 1 

TIPO 2D FORMAT2 (102%) 1 


Figura 18. Lista dello stato di libreria 
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LIBRERIA- TEMLIB DATA 08/07/83 ORA 14.43 


SUB RIF RIL MRT PROGRAMMA LUNGH. SPEC. TOTALE 
NOME. TIPO TIPO DATA ORA = NUMERO ATTRIBUTI LIV MAX AMPIEZ. KBYTE RECORD NUMERO SETTORI 
ALTCHR 0 03/26/82 15,58 000003 i 1 1 2 
CONCEPT 0 FMP 08/23/82 15.12 000001 FORMAT 1 (o) 9 
CONCEPTS 0 FMT 08/25/82 14.47 000001 FORMAT 1 o 13 
CONCMSG 0 10/14/82 14.36 000002 MSG 1 (e) 2 
. 
. 
. 
ALTCHR P 10/14/82 16,01 000001 NOLOG L 120 4 1 
ALTCHRBA P 10/14/82 12.35 000001 NOLOG 1 120 1 1 
ASMEM P ASM 10/14/82 12,36 000001 NOL0G 1 120 4 1; 
ASMM P ASM 10/14/82 12.38 000005 NOLOG 1 120 ll 2 
CATLIST P DTA 10/24/82 10.39 000007 NOLOG 1 120 9 2 
(] 
() 
0 
ALTCHR R 10/14/82 15.58 000003 1 3 
CONCEPT R DFU 10/14/82 15.12 000001 1 3 
CONCEPTS R BAS 10/14/82 1hk.55 000025 1 7 
DFU R DFU 10/14/82 16.28 000001 1 3 
EDITRECV R i 10/14/82 07.46 000001 1 12 
EDITSCR R 10/14/82 09.05 000001 1 68 
Fa 
. 
. 
A Ss DFU 10/14/82 16.22 000001 1 ho 5 di 
ALTCHR Ss ASM ‘10/14/82 15.55 000003 1 96 51 T 
CONCEPT S RPG' 10/14/82 15.02 000001 1 96 T 1 
CONCEPTS S FMI 10/14/82 14.46 000001 1 80 96 10 
CONCEPTI. S DFU 10/14/82 15,12 000001 1 ho 8 1 
CONCMSG ‘(Ss MSG 10/14/82 14.36 000002 MSG 1 96 - 6 2 


Figura 19. Lista dell’indirizzario di libreria, parametro USER 
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LIBRERIA- TEMLIB INDIRIZZ. DATA 08/07/83 ORA 1h,53 


SUB NUMERO LIV MAX PROGRAMMA NUM TESTO/ IND.COLLEG/ RIC ELEMENTO DISCO TOTALE 
NOME TIPO TIPO DATA ORA — RIF. ATTRIBUTI RIL MRT AMPIEZ. KBYTE LUNGH.REC. NUM.SPEC. DISP INDIRIZ, INDIRIZ SETTORI 


ALTCHR lo) 03/26/82 15.58 000003 000000200000 1 1 02 0000 BI 0000 021660 2 
CONCEPT 0 FMP 08/23/82 15.12 000001 100800201500 1 0 02 0000 00 0000 0217D6 9 
CONCEPTS 0 FMT 08/24/82 14.47 000001 100800201500 1 o 02 0000 00 0000 02180B 13 
CONCMSG 0 10/14/82 154.36 000002 000800200000 1 0 0000 00 0000 0217FF 2 
Cl) 

. 

. 

ALTCHR P 10/14/82 16.01 000001 00000200000 1 120 4 021645 1 
ALTCHRBA P 10/14/82 12.35 000001 400000204000 1 120 1 021646 1 
ASMEM P ASM. 10/14/82 12.36 000001 “400000203100 1 120 k 021647 1 
ASMM P ASM 10/14/82 12.38 000005 00000203100 1 120 11 02165B | 2 
CATLIST P DTA 10/24/82 10.39 000007. 400000200200 1 120 9 021755 Je 
COPYD P DTA = 10/24/82 10.38 000008 l00000200200 1 120 18 0217CE 3 
. 

o 

. 

ALTCHR R 10/14/82 15.58 000003 000000200000 1 0000 00 0000 02165D 3 
CONCEPT R DFU 10/14/82 15.12 000001 000000201400 1 0000 00 0000 0217D3. 3 
CONCEPTS R BAS 10/14/82 14,55 000025 000000203200 1 -0000 00 0000 O21TEC 17 
DFU R DFU 10/14/82 16.28 000001 000000201400 1 0000 00 0000 02176c 3 
EDITRECV R 10/14/82 07.46 000001 000000000000 1 0000 00 0000 0216AD 12 
EDITSCR R 10/14/82 09.05 000001 000000000000 1 0000 00 0000 021669 68 
. 

é. 

. 

A s DFU 10/14/82 16,22 000001 000000001400 1 ho 5 021762 1 
ALTCHR s ASM 10/14/82 15.55 000003 000000203100 1 96 sì : 021531 T 
CONCEPT S RPG 10/14/82 15.02 000001 000000203500 1 96 {{ 0217DI 1 
CONCEPTS S FMT 10/14/82 14.46 000001 000000201500 1 80 96 021801 10 
CONCEPTI S DFU 10/14/82 15.12 000001 000000001400 1 ho 8 0217D2 1 
CONCMSG. Ss MSG 10/14/82 14.36 000002 000000201700 1 96 6 O21TFD 2 


Figura 20. Lista dell’indirizzario di libreria, parametro DETAIL 
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LIBRERIA- TEMLIB 


SUB RIF 
NOME TIPO TIPO DATA ORA NUMERO APTRIBUTI 
ALTCHR P 10/14/82 16.01 000001 NOLOG 
// * *LOADING ALTERNATE CHARACTERS (ALTCHR)' 
// LOAD ALTCHR 
// PRINTER NAME-ALTCHAR,CPI-15,LPI-8,SPOOL-YES 
// RUN 
SUB RIF 
NOME TIPO TIPO DATA ORA NUMERO ATTRIBUTI 
ALTCHRBA P 10/14/82 12.35 000001 NOLOG 
// PRINTER NAME-ALTCHAR,LINES-65,CPI-15,LPI-8 
SUB RIF 
NOME TIPO TIPO DATA ORA NUMERO ATTRIBUTI 
ASMEM P ASM 10/14/82 12,36 000001. NOLOG 
// IF SUBR-'?1?,22'?CLIB?'?* REMOVE ?12,SUBR,72? 
// IF LOAD-'?1?,?2'?CLIB?'?' REMOVE ?12,L0AD,?2? 
ASM 217,222,22?,MAC 
OLINK ?1?,222,212,22? 
SUB RIF 
NOME TIPO TIPO DATA ORA NUMERO ATTRIBUTI 
ASMM P ASM 10/14/82 12,38 000005 NOLOG 
// PRINTER CONTINUE-YES,PRIORITY-O,SPOOL-YES 


DATA 08/07/83 


ORA 1k.3k 


PAG. l 


RIL 
LIV 


H 


RIL MRT 


MRT 
MAX 


// IF ?12='' * ‘Immettere il nome del membro origine da compilare' 


// IF SUBR-'?1R?,?2'?CLIB?'?"' REMOVE 21?,SUBR,?2? 


// IF LOAD-'?1?,22'?CLIB?'?' REMOVE ?17,LOAD,72? 
ASM 71? 222,222 ,MAC 

// IF ?CD?=1008 GOTO END 

OLINK 21?,222,212,22? 

// TAG END 

// PRINTER CONTINUE-NO 

// IF DATAF1-TEMPLE DELETE TEMPLE,F1 

COPYPRT ,TEMPLE,CANCEL,CRT 


Figura 21. Lista dei membri di libreria, parametro NOPAGE 


PROGRAMMA LUNGH. 
AMPIEZ. 


PROGRAMMA LUNGH, 
AMPIEZ. KBYTE RECORD 


120 


PROGRAMMA LUNGH. 
AMPIEZ. KBYTE RECORD 


PROGRAMMA LUNGH. 
AMPIEZ. KBYTE RECORD 


SPEC. 


SPEC, 
NUMERO 


SPEC. 
- NUMERO 


SPEC. 
NUMERO 


TOTALE 


KBYTE RECORD NUMERO SETTORI 


TOTALE 
SETTORI 


TOTALE 
SETTORI 
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LIBRERIA — SAMPLID 


SUB 
NOME TIPO TIPO 


COB 


FOR 
FOR 


FMIS Ss FMT 


INDIRIZZ. 


16/82/06 
02/24/83 
09/22/82 
12/03/82 
09/17/82 
01/25/83 


06/01/83 


08.33 


DATA 12/30/83 ORA 15.10 


RIF 
NUMERO 


000015 
000004 
000001 
000006 
000001 


000009 


ATTRIBUTI 


NONINQ 
FORMAT 


FORMAT 
FORMAT 


SSP 
ssp 


Figura 22. Lista dell’indirizzario di libreria, parametro DIRINFO 
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RIL MRT 
LIV. MAX AMPIEZ. KBYTE RECORD NUMERO SETTORI 


PPEWHWHE 


N 


PROGRAMMA 


LUNGH, 


96 


SPEC, 


24 


TOTALE 


Descrizione delle voci nella lista dell’indirizzario di libreria 


NOME specifica il nome del membro di libreria. 


TIPO specifica il tipo di membro di libreria: 


O Membro oggetto 

P__ Membro di procedura 
R. Membro di sottoroutine 
S Membro origine 


SUB TIPO specifica il sottotipo del membro: 


ARP. Membro auto report RPG 

ARS Membro a risposta automatica 

ASM Membro assembler 

BAP Procedura BASIC (membro origine) 

BAS Membro BASIC 

BGD Dati grafici gestionali 

BGF Tracciato grafici gestionali 

COB Membro COBOL 

CSM Membro comunicazioni e gestione sistema 

CSP. Membro prodotto sistema - incrociato 

DFU Membro utilità file dati 

DLS Membro servizi documenti libreria 

DTA Membro dati 

FMT_ Membro tracciato video 

FOR Membro FORTRAN 

ICF Membro Dispositivo Interattivo per le Comunicazioni procedura 
CNFIGICF 

KEY Procedura KEYS 

MNU Membro menù 

MSG Membro messaggi 

PHL  Membroelenco telefonico 

ODE Membro immissione Query 

QRY Membro Query 

RPG. Membro RPG 

SRT Membro Sort 

SSP Membro di configurazione sistema procedura CNFIGSSP 

TXT Membro testo 

UNS Non specificato 

WSU Membro utilità terminale 

X25 Controllo collegamento commutazione a pacchetti X.25 
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343.1 


DATA specifica la data (nel formato di sistema) in cui il membro è stato creato 0 
aggiornato per l’ultima volta, 


IS 


ORA specifica l'ora in cui il membro è stato creato o aggiornato per l’uitima 
volta. 


RIF NUMERO specifica il numero di riferimento assegnato al membro. 


ATTRIBUTI per il parametro USER: possono essere listati uno o più dei seguen- 
ti identificatori con il membro di libreria: 


CONFIG Un membro oggetto di configurazione CNF IGSSP 
FORMAT Un membro di tracciato video 


IBM Un membro fornito dalla IBM 

MENU Un membro oggetto o un'origine menu 

MRT_. Un programma per terminali richiedenti multipli o procedura 
MSG Un membro oggetto o un membro origine di messaggi 

NEP Un programma sempre residente in memoria o procedura 


NOLOG Le specifiche OCL della procedura non sono registrate sul file 
storico, cronologico l 


NONINO Il membro oggetto programma non è interrompibile 
PDATA La procedura ha passato dati ad un programma e non parametri 
SSP Un membro SSP 


RIL LIV è il livello di rilascio del SSP quando il membro è stato creato o 
quando il membro è stato aggiornato usando SEU o SDA. Per i membri co- 
piati da un file nem modo a settori Sistema/32 IBM, il livello di versione è 
232. Per i membri copiati da un file nel modo a settori del Sistema/34 IBM, 


il livello di versione è il livello di rilascio del Sistema/34 IBM. 


MRT MAX è solo per i membri oggetto (0). ll numero massimo di unità video 
richiedenti che possono essere collegate al programma. 


PROGRAMMA AMPIEZ. è solo per i membri oggetto (0). Il numero di Kbyte ri- 


chiesto per eseguire il programma. 


LUNGH. RECORD è solo per i membri di procedura (P) o origine (S). La lun- 
ghezza delle specifiche nel membro. 


SPEC. NUMERO è soltanto per i membri origine (S) e di procedura (P). ll nume- 
ro delle specifiche nel membro. 


TOTALE SETTORI specifica il numero totale di settori usati dal membro. 


Differenze per i listati dai parametri DETAIL: 


ATTRIBUTI per parametro DETAIL specifica 6 byte di attributi o indicatori che 
danno dettagliate caratteristiche del membro. Gli indicatori sono listati solo 
in esadecimale. 


Primo byte: 
Bit 


0 


Significato quando attivato (impostato a 1} 


Si tratta di un membro SSP. 


Per un membro oggetto (0) il programma può eseguire istruzioni 
previlegiate SVC (richiamo dal supervisore). 


Per un membro di procedura (P) le specifiche generate dalla proce- 


.dura, non sono registrate nel file storico, cronologico. 


ll programma non è interrompibile. 


Per un membro oggetto (0) il membro è un membro oggetto trac- 
ciato video. 


Per un membro di procedura (P), possono essere trasmessi solo dati 
(non parametri) al comando di procedura che richiama la procedura. 


Questo programma richiede che vengano àtlocati i file di lavoro 
$WORK e $SOURCE. $SOURCE deve essere riempito dalla tastiera 


‘© da un membro origine, 


Questo modulo SSP non fa parte del sistema base SSP. 


E’ stato applicato a questo programma una PTF (riparazione tempo- 
ranea di programma). 


Questo membro oggetto contiene sovrapposizioni. 
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Secondo byte: 


Bit 
0 


Significato quando attivato (impostato a 1) 


Si tratta di un programma dedicato (il programma non può essere 
eseguito contemporaneamente ad altri lavori). 


Si tratta di un NEP (programma sempre residente in memoria). 


Questo membro ha una tabella di indici di formato a riferimento in- 
crociato. Valido soltanto per i membri oggetto SSP. 


Se è attiva la riservatezza mediante parola d'ordine, il programma 
può ‘essere eseguito soltanto da un operatore che ha una classifica- 


zione di sicurezza di operatore di sistema o più elevata. 


Se non è attiva ia riservatezza mediante parola d'ordine, il pro- 
gramma può essere eseguito soltanto dalla console di sistema. 


Questo membro non può essere eseguito (non può essere caricato 
con una specifica OCL LOAD). 


Indica che il programma contiene un’area di programma comune, 
Questo programma richiede che venga calcolato un nuovo indirizzo 
oggetto al momento del caricamento per assicurarsi che il program- 
ma venga inserito nella memoria centrale in un punto oltre la sua 
ragione comune. 


Questo programma legge specifiche di controllo.di utilità. 


Questo programma contiene una tabella del tipo ‘’dove andare”. 
Esso è usato dal programma transiente di riferimento incrociato 
(#MAXRF) che risolve l’identificazione e gli indirizzi nel programma. 


Terzo byte: 
Bit 
0 


Significato quando attivato (impostato a 1} 
Questo programma richiede che venga allocato $WORK2. 
Questo programma non è interscambiabile. 


Indica’ una dedicazione ad alto livello, Questo programma non può 
essere eseguito contemporaneamente ad altri lavori oppure se un 
utente si è collegato a qualsiasi altra unità video. 


Questo programma richiede la serie di istruzioni FORTRAN (la 
serie di istruzioni scientifiche). 


Questo membro è un record di configurazione. Creato da CNFIGSSP 
o CNFIGICF. 


Questo membro deve essere trasferito (il modulo non sarà caricato 
usando la specifica OCL LOAD). 


Questo membro oggetto di tracciato video ha un riferimento incro- 


ciato. 


Quarto byte: 
Bit 
0 


Questo programma MRT (per terminali richiedenti multipli), richie- 
de una nuova copia del programma MRT da caricare. 


Significato quando attivato (impostato a 1) 
Questo programma richiede la serie di istruzioni BASIC. 
Questo membro è un membro IBM-pad. 


Indica se il membro proviene da questo sistema (anzichè da un altro 
sistema IBM ad esempio il Sistema/34 IBM). 


Questo membro è fornito dalla IBM. Questo bit viene usato per impedi- 
re la cancellazione, la copia o la lista di membri IBM. 


Questo membro è contenuto in un'estensione di libreria. 
Riservato. 
Questo membro è un sistema transiente. 


Può essere in esecuzione soltanto una copia di questo programma. 
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Quinto byte: 
Valore Tipo membro origine 


02 Membro dati 

11 Membro risposta automatica 

12 Specifiche programma auto report RPG 
13 Procedura BASIC 


14 Programma di utilità file di dati 
15 Specifiche tracciato video 

16 Menù 

17 Membro di messaggi 

18 Elenco telefonico 

19 Specifiche di selezione 

31 Programma Assembler 


32 Programma BASIC 
33 Programma COBOL 
34 Programma FORTRAN 


35 Specifiche programma RPG 
36 Specifiche programma WSU 
40 Tipo non specificato 
| 41 Diagramma per la grafica 
42 Dati grafici gestionali 
43 Tracciato grafici gestionali 
51 Membro di configurazione SSP-ICF 
52 Membro di configurazione di sistema 
53 Membro di testo correggibile 
54 Membro di testo in forma libera 
55 Membro di testo stampato 
56 Controllo collegamento commutazione a pacchetti X.25 
57 Membro comunicazioni e gestione sistema. 
58 Membro Query. 
59 Membro prodotto sistema incrociato. 
5A Membro immissione Query. 
5B Membro servizi documenti libreria. 


5C Procedura KEYS 


Sesto byte: 
Bit Significato quanto attivato (Impostato a 1) 
0 Modulo dinamicamente privilegiato 
1 Il membro deve essere interscambiato 
2-7 Riservato, 
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NUM TESTO/LUNGH. REC. specifica quanto segue: 


e Per i membri origine (S) e procedura (P), la lunghezza delle specifiche 
nel membro. 


e Per i membri oggetto (0) il numero dei settori di testo contenuti nel 
membro, esclusi RLD (dizionari di rilocazione), che sono le parti di un 
membro oggetto che vengono usati per aggiustare gli indirizzi della me- 
moria centrale quando il membro viene spostato nella memoria centrale. 


e Per i membri sottoroutine (R), il valore di categoria assegnato quando è 
stata assemblata la sottoroutine. 


IND. COLLEG/NUM. SPEC. per i membri oggetto (O), l'indirizzo della memoria 
centrale (in esadecimale) assegnato al membro quando è concatenato nella 
memoria centrale con altri membri oggetto. 


Per i membri origine (S) o i membri di procedura (P), il numero delle speci- 
fiche nel membro. 


RIC DISP è solo per i membri oggetto (0). Lo spostamento (in esadecimale), del 
primo RLD (dizionario di rilocazione), nel primo settore contenente gli RLD. 


ELEMENTO INDIRIZ è solo per i membri oggetto (O). L'indirizzo della memo- 
ria centrale (esadecimale) del punto di entrata del membro. 


DISCO INDIRIZ specifica l'indirizzo (in esadecimale) del primo settore del mem- 
bro di libreria. 


TOTALE SETTORI specifica i! numero totale di settori usati per contenere il 
membro di libreria. i 
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PROCEDURA LOAD3601 


La procedura LOAD3601 è per il sottosistema SSP-ICF Finance. La procedura 
LOAD3601 trasmette i contenuti di un file su disco dal Sistema/36 ad un'unità 
di controllo IBM 3601. Per eseguire la procedura LOAD3601, la locazione del- 
l'unità di controllo 3601 deve essere stata abilitata a comunicare con la sessione 
del monitor di sistema. 


Per ulteriori informazioni sulla procedura LOAD3601 e sul sottosistema SSP-ICF 
Finance, vedere il manuale /nteractive Communications Feature: Reference. 


LOAD3601 nome file,nome locazione 





nome file specifica il file su disco che contiene l'immagine del minidisco da tra- 
smettere all'unità di controllo. 


nome locazione specifica fa locazione dell’unità di controllo alla quale deve essere 
trasferita l’immagine del minidisco. 
Esempio 


Per trasmettere il file denominato SETUP360 ad un'unità di controllo nella loca- 
zione BANK1. 


LOAD3601 SETUP360,BANK1 


2 


PROCEDURA LOG 


La procedura LOG indica se le specifiche OCL e le specifiche di controllo pro- 
grammi di utilità in una procedura devono essere registrate nel file storico, crono- 
logico, ìindipendentemente dall'indicatore di registrazione delle specifiche nella 
procedura. -Ciò consente di creare proprie procedure con questo indicatore disat- 
tivato pur avendo le specifiche registrate sul file storico, cronologica mentre si sta 
eseguendo la ricerca e la correzione degli errori della procedura. Le specifiche che 
avviano le procedure e le informazioni di fine lavoro, sono sempre registrate nel 
file storico, cronologico. 


Le opzioni dal menù di supporto di testi esplicativi del sistema e dai menù dell’u- 
tente possono essere registrate nel file storico, cronologico immettendo LONG 
ON; ciò consente di determinare le opzioni usate da un operatore. La registrazio- 
ne di queste opzioni può essere disattivata immettendo LOG NORMAL o LOG 
OFF. i 


La specifica LOG elabora una specifica OCL LOG. 





NORMAL specifica che deve essere usato ciascun indicatore di registrazione della 
procedura. 


ON specifica che tutte le specifiche OCL devono essere registrate nel file storico, 
cronologico, indipendentemente dall'indicatore di registrazione della procedu- 
ra. Inoltre devono essere registrate anche le opzioni di menù utilizzate da un 
operatore. 


OFF specifica che non devono essere registrate nel file storico, cronologico le 
specifiche OCL indipendentemente dall'indicatore di registrazione della pro- 
cedura. Inoltre non devono essere registrate le opzioni del menù utilizzate 
da un operatore. 


Esempio 


Questo esempio mostra come impedire temporaneamente che le specifiche OCL 
nella procedura PROCA vengano registrate nel file storico, cronologico. 


LOG OFF 
PROCA 
LOG NORMAL 
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PROCEDURA MAINTX25 
La procedura MAINTX25 consente di visualizzare informazioni sul collegamento X.25 


e di modificare talune informazioni di configurazione di circuito virtuale e di canale 
logico. La procedura MAINTX25 è descritta nel manuale Using System/36 Com- 


munications. 


La procedura MAINTX25 non ha parametri. 


Esempio 
Per eseguire la procedura MAINTX25: 


MAINTX25 


PROCEDURA MCSCONV 


La procedura MCSCONV contense di convertire i caratteri in linguaggio nazionale 
da e in caratteri di linguaggio multinazionale. Le procedure di conversione sono 
descritte nell'’Appendice D, Programma di utilità di conversione serie di caratteri 


multinazionali. 


PROCEDURA MSGFILE 


Questa procedura permette l'utilizzo del file messaggi di sistema (# MESSAGE]. Si 
può ottenere quanto segue: 


e Definire l'ampiezza e la posizione del file messaggi. i 

* Listare i terminali video e gli utenti che hanno messaggi nel file. 

e Cancellare messaggi dal file. 

| messaggi inviati con il comando di controllo MSG o la specifica OCL MSG sono 


salvati nel file messaggi. 
Per definire l'ampiezza e la posizione del file messaggi: 


MSGFILE DEFINE, [numero di terminali video che ricevono messaggi |, 


[numero di utenti che ricevono messaggi |, [pumero di nessaggi |, 





Per listare i terminali video e gli utenti che hanno messaggi nel file. 


MSGFILE SUMMARY 


350.1 


Per cancellare messaggi dal file messaggi: 


MSGFILE CANCEL, | ALL .} ia unità video 


DISPLAY id utente 
USER 





DEFINE specifica l'ampiezza e la posizione del file messaggi. Il valore definito per 
il file messaggi ha effetto quando si esegue la procedura MSGFILE con i para- 
metri CANCEL e ALL, o quando si esegue un IPL ed il file messaggi è vuoto. 
I valori di definizione possono essere variati soltanto da altri valori di definizione. 


Se è attiva la riservatezza, solo il gestore della sicurezza o l'operatore di siste- 
ma può definire questi valori. Se la riservatezza non è attiva, DEFINE può esse- 
re specificato solo dall'operatore della console di sistema. 


numero di terminali video che ricevono messaggi specifica il massimo numero di 
terminali video che possono avere messaggi in qualsiasi momento. Se ad esempio 
è indicato 8, il file messaggi può contenere messaggi per otto differenti unità 
video nello stesso istante. 


Il numero massimo è 99. Il numero specificato viene arrotondato al multiplo 
di otto successivo. Il valore iniziale assunto è otto per un sistema con 30 Mb 
o meno di spazio su disco, e 128 per un sistema con più di 30 Mb. 


numero di utenti che ricevono messaggi specifica il massimo numero di utenti che 
possono ricevere messaggi in qualsiasi momento. Per esempio se è indicato ot- 
to, il file può contenere messaggi per otto utenti nello stesso momento. 


Il numero massimo è 99. Il numero specificato viene arrotondato al multiplo 
di otto successivo. Il valore iniziale assunto è otto per un sistema con 30 Mb 
o meno di spazio su disco, e 128 per un sistema con più di 30 Mb. 


numero messaggi specifica il numero massimo di messaggi che possono essere 
nel file messaggi in qualsiasi momento. li massimo è 9999. Il valore iniziale as- 
sunto è 46 su un sistema con 30 Mb o meno di spazio su disco, e 217 su un 
sistema con più di 30 Mb. 


A1, A2, A3, 0 A4 indica la preferenza su disco per il file messaggi; cioè l'unità disco 
che viene esaminata per prima nella ricerca di spazio disponibile. Se non è di- 
sponibile sufficiente spazio su quell’unità, vengono esaminate le altre unità (se 
esistono) e il file messaggi è inserito sull'unità disco meno usata. Se non è spe- 
cificata alcuna locazione, il sistema pone il file sull'unità disco A1. 
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SUMMARY specifica che deve essere creata una lista delle unità video e degli utenti 
che hanno messaggi nel file messaggi. Questa lista è visualizzata o stampata 
sulla stampatrice di sistema. Per informazioni sull’assegnazione della stampa- 
trice di sistema vedere le procedure PRINT o SYSLIST. 


CANCEL specifica che i messaggi dovranno essere cancellati. 


ALL specifica che tutti i messaggi devono essere rimossi dai file messaggi. Un nuo- 
vo file messaggi viene creato con i valori indicati nella procedura MSGFILE. Se l’am- 
piezza non viene indicata, il file messaggi avrà ampiezza uguale al valore assunto. 


Se è attività la riservatezza del sistema, solo il responsabile della sicurezza o l’ope- 
ratore di sistema possono rimuovere messaggi dal file messaggi. Se la riservatezza 
non è attiva, ALL può essere specificato solo dalla console di sistema. 


DISPLAY specifica che i messaggi di un determinato terminale video devono essere 
rimossi dal file messaggi. 


USER specifica che i messaggi di un determinato utente devono essere rimossi dal 
file messaggi. 


id unità video specifica VID di unità video i cui messaggi devono essere rimossi dal 
file messaggi. 


Se è attiva la riservatezza, solo il responsabile della riservatezza o l'operatore 
della console di sistema può rimuovere i messaggi dal file messaggi. Tutti gli 
operatori delle altre unità video possono rimuovere solo messaggi delle unità 
che stanno utilizzando. 


Se la riservatezza non è attiva, un operatore alla console di sistema può rimuo- 
vere i messaggi da tutte le unità video. Tutti gli operatori delle altre unità video 
possono rimuovere messaggi dalle unità video che stanno utilizzando. 


Se non è specificato I'ID di unità video, vengono rimossi i messaggi della sta- 
zione video da cui era stata lanciata ia procedura MSGFILE. 


350.3 


350.4 


id utente specifica "ID utente dell'operatore i cui messaggi devono essere rimossi 
dal file messaggi. 


Se è attiva la riservatezza solo il responsabile della riservatezza o l'operatore 
di sistema può rimuovere i messaggi di qualsiasi utente. Gli altri operatori pos- 
sono rimuovere solo i propri messaggi. 


Se la riservatezza non è attiva, un operatore alla console di sistema può rimuo- 
vere i messaggi di ogni utente. Gli operatori alle altre unità video possono ri- 
muovere soltanto i loro messaggi. 


Se non è specificato l'ID utente, i messaggi dell'utente che ha lanciato la pro- 
cedura MSGFILE vengono rimossi. 


PROCEDURA MSRIJE 


La procedura MSRJE avvia il programma di utilità immissione lavori a distanza 
in sessione multipla (MSRJE). Per ulteriori informazioni su MSRJE ‘vedere il 
manuale MSRJE Guide. 


Per leggere un file su disco: 


nome Locazione , | none sine], mnggaa |,{DISK|, 
Igemmaa | |(D) 


aalmmEg 


COMMAND| , DELETE), }|NOREL 
DATA NODEL RELEASE 
CONSOLE 





Per leggere un membro di libreria: 


libreria corrente (P) 
SOURCE 


(8) 


nome locazione, [pone nenibro | i libreria » | PROC 


COMMAND |,|DELETE},|NOREL 
DATA NODEL | {RELEASE 
CONSOLE 





nome locazione specifica la locazione con la quale deve essere eseguita la comu- 
nicazione. Il nome è assegnato quando il sottosistema MSRJE viene configu- 
rato durante la procedura CNFGICF. La locazione deve essere stata attivata 
dalla procedura ENABLE, I 


nome file specifica il file su disco che deve essere letto. fl file può essere sequen- 
‘ zuale, a indice o diretto. 


nome membro specifica il membro di libreria che deve essere letto. il membro di 
libreria può essere un membro origine o un' membro di procedura, 


nome libreria specifica la libreria che contiene il membro di libreria da leggere. 


351 


352 


mmggaa, ggmmaa o aammgg specifica la data di creazione del file su disco. La 


data se specificata deve essere nel formato della data di sessione; usare il co- 
mando STATUS SESSION per determinare il formato della data di sessione, 
Se questo parametro non viene specificato, viene usato il file su disco più re- 
cente. i 


DISK, PROC o SOURCE specifica se deve essere letto il file su disco o il mem- 


bro di libreria. Se non viene specificato alcun parametro, viene usato ii valore 
che è stato specificato quando è stato definito il sottosistema MSRJE usando 
la procedura CNFIGICF (il parametro TYPE). 


DISK o D specifica che il parametro del nome è un file su disco. 


PROC o P specifica che il parametro dei nome è un membro di procedura di 
libreria. 


SOURCE o S specifica che il parametro del nome è un membro origine di 
libreria. 


COMMAND o DATA specifica se il file su disco o il membro di libreria che viene 


letto contiene soltanto dati o dati e specifiche di controllo. Se non viene 
specificato nè COMMAND nè DATA, viene usato il valore che era stato spe- 
cificato quando è stato definito il sottosistema MSRJE usando la procedura 
CNFGICF (il parametro CMD). 


COMMAND specifica che il file su disco o il membro di libreria contiene spe- 
cifiche di controllo programmi di utilità MSRJE. Il MSRJE elabora tutte le 
specifiche di controllo e trasmette tutti gli altri record o specifiche. Se le 
specifiche di controllo sono contenute in un file su disco, il file viene elabo- 
rato consecutivamente e deve avere una lunghezza di record di 80. 


DATA specifica che ii file o il membro di libreria che viene letto contiene 
dati. Se viene letto un file su disco, i record sono elaborati consecutivamente. 


DELETE o NODEL specifica, nel caso venga elaborato un file su disco, se devo- 


no essere elaborati i record canceliati nel file. Se dal file su disco non si pos- 
sono cancellare record, questo parametro è ignorato. Se non viene specifica- 
to nè DELETE nè NODEL, viene usato il valore che è stato specificato 


quando è stato definito il sottosistema MSRJE usando la procedura CNFI- 
GICF (il parametro DEL). 


DELETE specifica che devono essere trasmessi i record cancellati. 


NODEL specifica che non devono essere trasmessi i record cancellati. 


ZA 


NOREL specifica che si desidera soltanto una funzione di programma di lettura 
e che l’unità video deve rimanere collegata al programma di lettura MSJRE 
durante la trasmissione dei dati, Ciò consente di immettere comandi MSRJE. 
sil Se non viene specificato alcun parametro, si assume NOREL. 


RELEASE specifica che si desidera soltanto una funzione di programma di lettu- 
ra e che l'unità video deve essere rilasciata dal programma di lettura MSJRE 


per consentire di eseguire altre funzioni sull'unità video mentre i dati vengo- 
no trasmessi. 


CONSOLE specifica che l’unità video che viene usata deve essere una console 


MSRJE. Se viene già usata un'altra unità video, come console MSRJE, viene 
visualizzato un messaggio. 


Esempio 1 


Questo esempio mostra come collegarsi al MSRJE come operatore di console 
MSRIE. 


MSRJE STATIONI,,,3s CONSOLE 


Esempio 2 
Questo esempio mostra come collegarsi al MSRJE e trasmettere un membro origi- 
ne di libreria che contiene dati e specifiche di controllo MSRJE. Il nome del membro 
di libreria è PAYROLL; esso è contenuto nella libreria denominata MYLIB. 


MSRJE STATION] ,PAYROLL,MYLIB,SOURCE,COMMAND 
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NOHALT 


PROCEDURA NOHALT 


La procedura NOHALT specifica il livello di gravità di risposta automatica per il 
sistema, la sessione o il singolo lavoro, Ciò consente di avere messaggi con valori 
di risposta ai quali il sistema risponde automaticamente anzichè dover ricorrere 
ad un operatore per immettere la risposta ad un messaggio di errore. 


Per ulteriori informazioni sulla risposta automatica e sul livello di gravità, vedere 
la Procedura RESPONSE. 


Se è immessa dalla tastiera, rimane valida fino a che non viene immessa un’altra 
procedura NOHALT o fino a che l'operatore non si scollega dal sistema. Se è 


specificata in una procedura, rimane valida fino a che non è elaborata un'altra 
procedura NOHALT o fino a che il lavoro termina. 


La procedura NOHALT elabora una specifica OCL NOHALT. 


livello di gravità,jJOB 


SESSION 
SYSTEM 





livello di gravità specifica il livello di gravità di risposta automatica, E’ possibile 
immettere 0, 1, 2,30 4: 


O Zero specifica che non si deve rispondere automaticamente ad alcun 
messaggio. Se viene visualizzato un messaggio, l'operatore deve immette- 
re una risposta al messaggio. 


1 Specifica che il sistema deve rispondere automaticamente a qualsiasi mes- 
saggio avente un livello di gravità 1. 


2. Specifica che il sistema deve rispondere automaticamente a qualsiasi mes- 
saggio avente un livello di gravità 1 o 2. 


3. Specifica che il sistema deve rispondere automaticamente a qualsiasi mes- 
saggio avente un livello di gravità 1, 2 o 3. 


4 Specifica che il sistema deve rispondere automaticamente a qualsiasi mes- 
saggio avente un livello di gravità 1, 2,304. 


JOB specifica che il livello di gravità deve influire soltanto sul lavoro corrente che 
contiene la procedura NOHALT. Se non viene specificato alcun parametro 
quando s'incontra la procedura NOHALT in un lavoro o in una procedura, si 
presume JOB. A} termine del lavoro, viene usato il livello di gravità che è va- 
lido per la sessione. 


SESSION specifica che il livello di gravità deve influire sulla sessione; cioè su tutti 
i lavori fino a che non si scollega dal sistema. Se NOHALT è in una procedura, 
ed è specificato SESSION, il livello di gravità non ha effetto sino a che non ter- 
mini il lavoro in esecuzione. Se non viene specificato alcun parametro quando 
si immette la procedura NOHALT dalla tastiera, si presume SESSION. 


SYSTEM specifica che il livello di gravità deve stabilire il livello di gravità del si- 
stema; cioè il livello di gravità per le unità video che si collegano dopo che 
viene elaborato il parametro SYSTEM. Le unità video che erano già collegate 
non sono interessate. 


Per stabilire il livello di gravità del sistema prima che qualsiasi operatore si 


colleghi al sistema, includere la procedura NOHALT nella procedura #STRT- 
UP1 di avviamento del caricamento del programma iniziale (IPL). Vedere 
Procedura #STRTUPI per ulteriori informazioni. 


Se è attiva la riservatezza mediante parola d'ordine, è possibile specificare 
SYSTEM soltanto da un operatore avente la classificazione di operatore di si- 
stema o più elevata. Se non è attiva la riservatezza mediante parola d'ordine, 
è possibile specificare SYSTEM soltanto sulla console di sistema. 


Se NOHALT è in una procedura ed è specificato SYSTEM, il livello di gravità ha 
effetto immediatamente per il sistema, ma non per quelle unità video che hanno 
lavori in esecuzione. $ 


Esempio 1 


Per stabilire un livello di gravità di risposta automatica di 3 per l’intero sistema, 
si potrebbe inserire la seguente specifica nella procedura denominata #TRTUP1. 


NOHALT 3,SYSTEM 


Esempio 2 


Per stabilire un livello di gravità di risposta automatica di 3 per il programma 
PAYROLL, si potrebbe specificare quanto segue nella procedura PAYROLL. Il 
livello di gravità 3 interessa soltanto le specifiche che seguono la procedura 
NOHALT; al termine della procedura, si riprende il livelio di gravità della sessione. 


NOHALT 3 

// LOAD PAYROLL 

// FINE NAME-EMPLOY,DISP-OLD 
// RUN 


Esempio 3 


Per stabilire un livello di gravità di risposta automatica di 3 per la sessione, im- 
mettere quanto segue dalla tastiera: 


NOHALT 3 


OFCCAL 


355.1 


PROCEDURA OFCCAL 


La procedura OFCCAL crea e aggiorna un calendario utilizzando il PS/36, SI può creare, 
variare o cancellare un calendario e schedulare o cancellare voci di calendario. 


Per maggiori informazioni vedere l'informazione in linea sul PS/36. 
Per leggere l'informazione in linea: 


e Eseguire la procedura READINFO. Per PS/36 specificare: 
READINFO #0OFCDOC,#0OFCLDR 
e Scegliere l'opzione 11 dal menù di utilizzo PS/36 


e Premereil tasto di ausilio da qualsiasi schermo PS/36. 


MYCAL|,|CHANGE 
OTHER CREATE 


DELETE 





WORK specifica che si vogliono vedere o variare voci in un calendario o gruppo di 
calendari. Se non è indicato alcun parametro, viene assunto WORK. 


PRINT specifica che si vogliono stampare o cancellare voci di calendario. 


UPDATE specifica che si vuole creare, variare o cancellare un calendario. UPDATE varia 
la descrizione di un calendario. 


MYCAL specifica che si vuole lavorare con il calendario o gruppo di calendari elencati 
nel profilo d'ufficio. Se non si specifica alcun parametro, viene assunto MYCAL. 


OTHER specifica che si vuole lavorare con un calendario diverso da quelli elencati nel 
profilo d'ufficio. 


CHANGE specifica che si vuole variare la descrizione o il gestore di un calendario. Se 
è attiva la riservatezza si può variare anche l’entrata del calendario nel file riserva- 
tezza risorse. 


CREATE specifica che si vuole creare un calendario. Per creare un calendario, gli si 
deve assegnare un gestore e specificare il numero massimo di voci. Si può anche 
associare una descrizione al calendario; se è attiva la riservatezza risorse, si può 
aggiungere il calendario al file riservatezza risorse. 


DELETE specifica che si vuole rimuovere il calendario dal sistema. 


l PROCEDURA OFCBPRT 
e di cancellare elementi di un calendario senza servirsi dei menu e degli schermi del 
Personal Services/36 (PS/36). 


Per maggiori informazioni, vedere l’informazioni in linea. Per leggere l'informazione 


| La procedura OFCBPRT consente all'utente di richiedere una stampa a blocchi (batch) 
| in linea: 


e Esequire la procedura READINFO. Per PS/36 specificare: 


READINFO #OFCDOC, #OFCLDR 


e Scegliere l'opzione 11 dai menù di utilizzo PS/36. 


I * Premere il tasto di ausilio da qualsiasi schermo PS/36. 









OFCBPRT [rome calendario | ; [datata] ; [data |. PRT ) [modulo di stampa | X 
PRTDEL 










| stampatrice | , | 10 ; {6 : {60 
caratteri per pollice righe per pollice righe per pagina 
l 
# di copie. 





nome calendario specifica il nome del calendario da stampare o cancellare. Se que- 
sto parametro non viene specificato, si assume il nome presente nel profilo 
utente. 


data-da, data-a specifica l'intervallo di tempo perchè il calendario sia stampato o 
cancellato. Se data-da non viene indicata, questa viene calcolata mediante le 
voci del calendario. Se data-a non viene indicata, questa risulterà la data ulti- 
ma della settimana precedente. 


355.1.1 


355.1.2 


PRT specifica che deve essere stampato il calendario. Se questo parametro non è 
indicato, viene assunto PRT. 


PRTDEL specifica che il calendario deve essere stampato e poi cancellato. 


modulo stampa specifica il tipo di carta da usarsi. Se non specificato, viene assunto 
0001. 


ID stampatrice specifica l'ID della stampatrice per la stampa del calendario. Se non 
specificata, viene usato l'ID di stampatrice definita nel profilo utente. 


caratteri per pollice specifica il numero di caratteri per pollice. Se non specificato, 
viene assunto 10. 


righe per pollice specifica il numero di righe per pollice. Se non specificato, viene 
assunto 6. 


righe per pagina specifica il numero di righe per pagina. Se non specificato, viene 
assunto 60. ° 


# di copie specifica il numero di copie da stampare. Se non viene specificato viene 
assunto 1. 


PET 


PROCEDURA OFCDATA 
La procedura OFCDATA riorganizza o salva l'informazione d'ufficio. L'informazione d’uf- 
ficio comprende file e cartelle PS/36 inclusi calendari e registrazioni postali. La procedu- 
ra OFCDATA dovrà essere eseguita senza che nessun altro utilizzi il PS/36. 


Per maggiori informazioni vedere l'informazione in linea sui PS/36. 
Per leggere l'informazione in linea: 


* Eseguire la procedura READINFO. Per PS/36 specificare: 
READINFO #OFCDOC, #OFCLDR 
® Scegliere l'opzione 11 dal menù di utilizzo PS/36 


e Premereiltasto di ausilio da qualsiasi schermo PS/36. 


OFCDATA |RORG 


SAVE 





REORG specifica che l'informazione d’ufficio deve essere riorganizzata. 


SAVE specifica che l'informazione d'ufficio deve essere salvata su minidisco o nastro. 


355.2 


PROCEDURA OFCDFLT 


La procedura OFCDFLT varia i valori assunti automaticamente dal PS/36. Se è attività 
la riservatezza mediante parola d'ordine, il responsabile della sicurezza può variare i va- 
lori assunti automaticamente. Si possono variare i valori per il proprio profilo d'ufficio. 


Per maggiori informazioni vedere l'informazione in linea sul PS/36. 
Per leggere l’informazione in linea: 


e Eseguire la procedura READINFO. Per PS/36 specificare: 
READINFO #0OFCDOC,#OFCLDR 
® Scegliere l'opzione 11 dal menù di utilizzo PS/36 


e Premere il tasto di ausilio da qualsiasi schermo PS/36. 


OFCDFLT |USER 


OFFICE 





CI 


USER specifica che si vogliono variare i valori assunti automaticamente del proprio . 
profilo d'ufficio. Se non è indicato alcun parametro, viene assunto USER. 


OFFICE specifica che si. vogliono variare i valori assunti automaticamente. Solo il 
responsabile della riservatezza può variare questi valori. 
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PROCEDURA OFCDIR 


La procedura OFCDIR sceglie diversi modi per guardare l'indirizzario, 


Per maggiori informazioni vedere l'informazione in linea sul PS/36. 
Per leggere l'informazione in linea: 


e Eseguire la procedura READINFO, Per PS/36 specificare: 
READINFO #0FCDOC,#0FCLDR 
e Scegliere l'opzione 11 dal menù di utilizzo PS/36 


e Premere il tasto di ausilio da qualsiasi schermo PS/36. 


OFCDIR 





USER specifica che si vogliono guardare nomi, indirizzi, e numeri telefonici in ordine 
alfabetico di identificatore utente. Se non viene indicato aicun parametro, viene 
assunto USER. 


GROUP specifica che si vogliono guardare i nomi, gli ID utenti, gli indirizzi di distribuzio- 
ne ed in numeri telefonici dei membri di un gruppo. Non si possono aggiungere o 
cancellare nomi nell'indirizzario o gruppo. 


NAME specifica che si vogliono guardare gli indirizzi degli utenti nell’indirizzario în 
ordine alfabetico. Si possono aggiungere, variare o cancellare entrate 
nell’indirizzario. 

PHONE specifica che si vogliono guardare i numeri di telefono degli utenti nell’indirizza- 
rio in ordine alfabetico. Si possono aggiungere, variare o cancellare entrate nell'in- 
dirizzario. 
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PROCEDURA OFCGRP 


La procedura OFCGRP permette di lavorare con un gruppo di utenti. 


Per maggiori informazioni vedere l'informazione in linea sul PS/36. 
Per leggere l'informazione in linea: 


e Eseguire la procedura READINFO. Per PS/36 specificare: 
READINFO #O0FCDOC,#0FCLDR 
e Scegliere l'opzione 11 dal menù di utilizzo PS/36 


® Premereil tasto di ausilio da qualsiasi schermo PS/36. 


OFCGRP 





La procedura OFCGRP non ha parametri, 
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PROCEDURA OFCINSTL 
La procedura OFCINSTL installa i file PS/36 sul sistema. 


Per maggiori informazioni vedere l'informazione in linea sul PS/36. 
Per leggere l'informazione in linea: 


e Eseguire la procedura READINFO. Per PS/36 specificare: 
READINFO #0FCDOC,#0FCLDR 
® Scegliere l'opzione 11 dal menù di utilizzo PS/36 


e Premereil tasto di ausilio da qualsiasi schermo PS/36. 


OFCINSTL 


La procedura OFCINSTL non ha parametri. 
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PROCEDURA OFCLOAD 


La procedura OFCLOAD crea una libreria denominata # OFCLIB e copia il supporto PS/36 
da minidisco nella libreria. Copia supporti addizionali nella libreria di sistema (# LIBRA- 
RY). Può inoltre copiare sia minidischi PID (centro distribuzione IBM) che minidischi creati 

l dalla procedura OFCSAVE. Vedere la procedura OFCSAVE per informazioni su co- 
me salvare il supporto PS/36 su minidisco. 


La procedura OFCLOAD potrebbe modificare il record principale di configurazione con 
conseguente discordanza con il membro di configurazione. Per modificare il membro 
di configurazione vedere il manuale ‘MODIFICA DELLA CONFIGURAZIONE DEL SISTE- 
MA”. Si dovrà utilizzare la procedura CNFIGSSP per aggiungere supporto al sistema. 
Si può utilizzare la procedura OFCLOAD per ripristinare il supporto che era stato salvato 
con la procedura OFCSAVE. 


| Se il PS/36 non è in uso sul sistema, è necessario copiare con la procedura TOLIBR 
il file su minidisco OFC nella libreria # LIBRARY prima di eseguire OFCLOAD. 


| Se #LIBRARY con il PS/36 era stata salvata e poi ripristinata, prima di eseguire 
OFCLOAD non è necessario copiare il file OFC su minidisco con la procedura TOLIBR. 


OFCLOAD 





A1, A2, A3, o A4 indica la preferenza del disco: cioè l'unità disco chg viene esaminata 
per prima nella ricerca .di spazio disponibile. Se non è disponibile sufficiente spazio 
su quel’unità, vengono esaminate le altre unità (se esistono) e # OFCLIB viene in- 
serita sull'unità disco menu usata. Se non sono specificate alcune locazioni ed il 
sistema dispone di più di un'unità disco, # OFCLIB è inserita nell'unità disco meno 
usata. 


A1 specifica che # OFCLIB deve essere inserita sul primo disco, se c'è spazio di- 
sponibile. 


A2 specifica che #OFCLIB deve essere inserita sui secondo disco, se c'è spazio 
disponibile. 


A3 specifica che # OFCLIB deve essere inserito sul terzo disco, se c'è spazio dispo- 
nibile. 


A4 specifica che # OFCLIB deve essere inserita sul quarto disco, se c'è spazio di- 
sponibile. 
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S1, $2 o $3 specifica l'alimentatore a minidischi contenente il primo minidisco da 
usare. Se non è specificata alcuna posizione di minidisco, si presume S1. 


M1.nn o M2.nn specifica la locazione dei caricatore che contiene il primo minidisco da 
usare. M1 indica il primo caricatore e M2 indica il secondo. nn è un valore decimale 
da 01 a 10 che identifica la locazione del minidisco nel caricatore. Specificare M1 
equivale a specificare M1.01. Specificare M2 equivale a specificare M2.01. 


Esempio 
Creazione di #OFCLIB su disco e copia del supporto PS/36 da minidisco. 


OFCLOAD 
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OFCMAIL 


355.9 


PROCEDURA OFCMAIL 


STATUS 


ACTION 
ALTERLOG 
HARDCOPY 


MAILOUT 
RECEIVE 
REVLOG 
SELECT 
SEND 


Con le OFCMAIL si gestisce la posta. Si può guardare lo stato di tutte le entrate nella 
registrazione postale. Si può inviare posta e guardare lo stato della posta inviata. 


-Il PS/36 automaticamente registra tutta la posta inviata o ricevuta mediante il sistema, 
ed è possibile registrate ogni copia di posta inviata o ricevuta. 

Con la procedura OFCMAIL si può creare o cancellare un registro postale o lavorare 
con un particolare registro utente. 


Per maggiori informazioni vedere l'informazione in linea sul PS/36. 
Per leggere l'informazione in linea: 


e Eseguire la procedura READINFO. Per PS/36 specificare: 
READINFO #0OFCDOC,#OFCLDR 
® Scegliere l'opzione 11 dal menù di utilizzo PS/36 


e Premere il tasto di ausilio da qualsiasi schermo PS/36. 





STATUS specifica che si vuole guardare lo stato delle entrate nel proprio registro postale. 
Si possono guardare nuove entrate, entrate di posta in partenza e elementi da avviare. 


ACTION specifica che si vogliono guardare gli elementi da avviare nel proprio registro 
di posta. Si può guardare l'elemento, cambiare la descrizione dell'elemento, spedi- 
re o cancellare l'elemento. Si può inoltre cancellare l’entrata dell'elemento nel regi- 
stro di posta. 


ALTERLOG specifica che si vuole creare o cancellare un registro di posta. Se è attività 
la riservatezza risorse, si può anche aggiungere il registro di posta al file di sicurez- 
za risorse. 


HARDCOPY specifica che si vuole una copia del registro di posta. Si possono immettere 
le stesse informazioni che il PS/36 automaticamente registra per la posta in parten- 
za ed in arrivo. 


MAILOUT specifica che si vogliono guardare le entrate della posta in partenza. È una 
lista di posta già inviata ma ancora non giunta al destinatario. 


RECEIVE specifica che si vuole guardare una lista di posta nuova nel proprio registro. 
Si possono guardare gli elementi, cambiare le loro descrizioni ed inviarli o cancellar- 
li. Si può inoltre cancellare l’entrata di un elemento dal registro di posta. 


REVLOG specifica che si vuole guardare una lista di entrate nel registro di posta, ordina- 
te per data con le più recenti in testa. Si può cancellare l’entrata di un elemento 
dal registro di posta. 


SELECT specifica che si vuole scegliere un registro di posta da una lista di utenti che 
hanno registri di posta. 


SEND specificare che si vuole inviare posta. Si può specificare una lista di distribuzione, 
una priorità, ed una classificazione di sicurezza. ll documento da inviare viene scel- 
to da una lista di documenti. 
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PROCEDURA OFCMAINT 


La procedura OFCMAINT gestisce l'informazione d'ufficio. Si possono gestire le defini- 
zioni delle code di comunicazione, le vie di comunicazione, o le cartelle di posta. Si può 
inoltre listare il contenuto di una cartella di posta. Eccetto che per la lista dei contenuti 
di cartella di posta, la procedura OFCMAINT non può essere eseguita se qualcun altro 
lavora con il PS/36. 


Per maggiori informazioni vedere l'informazione in linea sul PS/36. 
Per leggere l'informazione in linea: 


e Eseguire la procedura READINFO. Per PS/36 specificare: 
READINFO #OFCDOC,#0OFCLDR 
* Scegliere l'opzione 11 dal menù di utilizzo PS/36 


e Premereil tasto di ausilio da qualsiasi schermo PS/36. 


OFCMAINT |QUEUES 


ROUTES 


MAILFLDR 
REPORT 
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QUEUES specifica che si vuole guardare ogni definizione coda comunicazioni e aggiun- 
gere o scegliere entrate da modificare o cancellare. 


ROUTES specifica che si vuole guardare ciascuna via di comunicazione e aggiungere 
o scegliere entrate da modificare o cancellare. 


MAILFLDR specifica che si vuole guardare o gestire una cartella di posta. Si può 
muovere un elemento e guardare o cancellare l'elemento dalla cartella di posta. 


REPORT specifica che si vuole produrre un prospetto che listi gli elementi nella cartella 
di posta e gli utenti che abbiano accesso ad essi. 


on 


Voilà 


Val 


PROCEDURA OFCMSG 


Questa procedura consente di inviare messaggi ad un gruppo. 


Per maggiori informazioni vedere l'informazione in linea sul PS/36. 
Per leggere l'informazione in linea: 


e Eseguire la procedura READINFO. Per PS/36 specificare: 
READINFO #OFCDOC, #OFCLDR 
e Scegliere l'opzione 11 dal menù di utilizzo PS/36 


e Premereiltasto di ausilio da qualsiasi schermo PS/36. 


OFCMSG 


La procedura OFCMSG non ha parametri. 


355.12 


PROCEDURA OFCO 


La procedura OFCOQ controlla l’attività delle code di comunicazione. 


Per maggiori informazioni vedere l'informazione in linea sul PS/36. 
Per leggere l'informazione in linea: 


e Eseguire la procedura READINFO. Per PS/36 specificare: 
READINFO #0FCDOC,#0OFCLDR 
® Scegliere l'opzione 11 dal menù di utilizzo PS/36 


* Premere i tasto di ausilio da qualsiasi schermo PS/36. 


OFCQ |ACTIVITY|,|START 


COMM STOP 





ACTIVITY specifica che si vuole avviare o fermare la coda delle attività. Se non viene 
specificato alcun parametro, viene assunto ACTIVITY. 


COMM specifica che si vogliono controllare le code di comunicazione. 
START specifica che si vuole avviare la coda delle attività. Se la coda di attività non 
è avviata, i lavori a blocchi ed i messaggi schedulati sui calendari PS/36 non vengo- 


no inviati. Se non si specifica alcun parametro, viene assunto START. 


STOP specifica che si vuole fermare la coda delle attività. 
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PROCEDURA OFCSAVE 


La procedura OFCSAVE copia il supporto PS/36 su minidisco. Il supporto PS/36 viene 
copiato dalle librerie # OFCLIB e # LIBRARY. Si dovrà utilizzare la procedura OFCLOAD 
per caricare il supporto PS/36 da un minidisco di riserva. Il minidisco contenente fa co- 
pia salvata deve avere l'ID di volume PPOFC. 


OFCSAVE 





S1, S2 o S3 specifica l'alimentatore a minidischi contenente il primo minidisco da 
usare. Se non è specificata alcuna posizione di minidisco, si presume S1. 


M1.nn o M2.nn specifica la locazione del caricatore che contiene il primo minidisco da 
usare. M1 indica il primo caricatore e M2 indica il secondo. nn è un valore decimale 
da 01 a 10 ché identifica la locazione del minidisco nel caricatore. Specificare M1 
equivale a specificare M1.01. Specificare M2 equivale a specificare M2.01. 


355.14 


PROCEDURA OFCUSER 


La procedura OFCUSER iscrive o modifica l’istruzione di utenti PS/36 generali e indiret- 
ti. Un utente indiretto non è iscritto. 


Per maggiori informazioni vedere i'informazione in linea sul PS/36. 
Per leggere l'informazione in linea: 


* Eseguire la procedura READINFO. Per PS/36 specificare; 
READINFO #0FCDOC,#0FCLDR 
®e Scegliere l'opzione 11 dal menù di utilizzo PS/36 


* Premere il tasto di ausilio da qualsiasi schermo PS/36. 





OFCUSER |ENROLLI ,{| OFC 
CHANGE DW 





ENROLL specifica che si vogliono iscrivere utenti PS/36. Se non si specifica alcun para- 
metro, viene assunto ENROLL. 


CHANGE specifica che si vuole guardare una lista di utenti generali e indiretti. Con la 
lista, si possono variare o rimuovere entrate di indirizzario o iscrizioni. 


OFC specifica che si vuole iscrivere o modificare l'iscrizione di un utente generale. Se 
non viene alcun parametro, OFC viene assunto. 


DW specifica che si vuole iscrivere o modificare l'iscrizione di un utente indiretto. 
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PROCEDURA OLIN K 


La procedura OLINK esegue l'edizione di moduli oggetto di programmi compilati 
e sottoroutine per creare un membro oggetto di libreria eseguibile. Per ulteriori 
informazioni sulla procedura OLINK, vedere il manuale OLE Guide. 


nome membro,|nome libreria di immissione] ,jnome membro oggetto], 
libreria corrente nome membro 





libreria membro oggetto], [attrituto.| ,|attritutor| a 
libreria corrente 





num. massimo terminali|,|librerial sottoroutine 
0) nome libreria di immissione 


libreria? sottoroutine ,| coda lavori|,|opzione stampa mappa 
nome libreria di immissione| |NO Y 


YES N 





XREF 





nome membro specifica il programma compilato da sottoporre a edizione di 
moduli oggetto nel membro oggetto eseguibile. Il membro deve essere un 
membro di sottoroutine di libreria. Se questo parametro non viene immesso, 
compare lo schermo che richiede i parametri. 


nome libreria d’immissione specifica la libreria che contiene il programma compi- 
lato da sottoporre a edizione di moduli oggetto. Se non viene immesso alcun 
parametro, si presume la libreria corrente. 


nome membro oggetto specifica il nome da assegnare al programma che è stato 
sottoposto a edizione di moduli oggetto. Se non viene immesso alcun para- 
metro, si presume member name. 


libreria membro oggetto specifica la libreria che deve contenere il programma che 


è stato sottoposto a edizione di moduli oggetto. Se non viene immesso alcun 
parametro, si presume la libreria corrente. 
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attributo1, attributo2 specifica gli attributi o gli indicatori che devono essere as- 
segnati al membro oggetto sottoposto a edizione di moduli oggetto. Possono 
essere immessi soltanto due attributi, Gli attributi che è possibile immettere 
sono i seguenti: 


COM indica che il membro oggetto richiede il catcolo di un nuovo indirizzo 
di caricamento quando il programma viene caricato, Ciò assicura che il nuovo 
indirizzo di caricamento nella memoria centrale è oltre la regione comune 
propria del programma, 


DED indica che il membro oggetto deve essere eseguito da solo sul sistema 
(dedicato). Non può essere eseguito contemporaneamente un altro pro- 
gramma. 


LSC indica, che il programma può essere caricato {ed eseguito) soltanto dalla 
console di sistema, 


NEP indica che il programma è sempre residente in memoria. Ciò significa 
che qualsiasi risorsa di sistema (ad esempio i file su disco o le stampatrici) 
usata dal programma non sarà disponibile ad altri programmi. Ciò evita che 
altri programmi attendano fino al termine del programma NEP. 


NEX indica che il membro oggetto non può essere eseguito (non è eseguibi- 
le). 1l membro non può essere caricato usando una specifica OCL LOAD. Se 
viene specificato NEX, non può essere specificato alcùno degli altri attributi. 


NIO indica che il programma non è interrompibile. Cioè non è possibile ese- 
guire un altro programma mentre viene eseguito il programma NIO. 


NSW indica che il programma non è scambiabile. Ciò significa che una volta 
che il programma è caircato rimane nella memoria centrale fino a che non 
termina e che non viene quindi scambiato all’interno e all’esterno della me- 
moria principale. Per informazioni sull’interscambio, vedere il manuale Con- 


cepts ad Programmer'’s Guide. 


SIS indica che il programma richiede l'esecuzione di Scientific Instructions 
Set. 


SRO indica che il programma richiede l'allocazione dei file $SOURCE e 
$WORK. 


UCS indica che il programma legge specifiche di controllo di programmi di 
‘ utilità. 


num. massimo terminali indica che si tratta di un programma per terminali richie- 
denti multipli (MRT) e specifica il numero massimo di terminali che possono 
usare il programma contemporaneamente. E’ possibile immettere qualsiasi 
numero da 0 a 255. 


Se viene immesso 0, il programma è per terminale richiedente singolo e non 
MRT. Se non viene immesso alcun parametro, si presume 0, 


libreria1 sottoroutine, libreria2 sottoroutine specifica i nomi di un massimo di 2 


librerie in cui cercare i membri di sottoroutine. Se non vengono specificati i 
parametri, si presume la libreria di immissione. 
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coda lavori specifica se il lavoro OLINK deve essere inserito nella coda dei lavori. 


NO specifica che il lavoro OLINK non deve essere inserito nella coda dei la- 
vori. Se non viene immesso alcun parametro, si presume NO, 


YES specifica che il lavoro OLINK deve essere inserito nella coda dei lavori. 


opzione stampa mappa specifica il tipo di emissione stampata da produrre dall'e. 


dizione di moduli oggetto. Se non viene specificato alcun parametro, si pre- 
sume Y. 


Y specifica la stampa di una mappa di memoria e di messaggi. 


N specifica che non deve essere stampata alcuna mappa di memoria o alcun 
messaggio. 


MSG specifica che si devono stampare soltanto messaggi. 


XREF specifica la stampa di una mappa di memoria, di una lista di riferi 
menti incrociati e di messaggi. 


MRO o NOMRO specifica se il compilatore è da usarsi con strutture overlay residenti 


in memoria. Se non viene specificato alcun parametro, viene assunto NOMRO. 


MRO specifica che il compilatore è da usarsi con strutture overlay residenti in 
memoria. 


NOMRO specifica che il compilatore non è da usarsi con strutture overlay resi- 
denti in memoria. 


Esempio 


Questo esempio mostra come eseguire l'edizione di moduli oggetto del program- 
ma PAYROLL. li programma compilato è contenuto nella libreria PAYLIB e il 
membro oggetto risultato dell'edizione deve essere inserito in PAYLIB. Il nome 
del membro oggetto risultato della edizione deve essere anche PAYROLL. Il pro- 
gramma deve essere non interrompibile e può essere eseguito soltanto dalla con- 
sole di sistema. Qualsiasi sottoroutine richiesta durante il processo di edizione di 


moduli oggetto, deve essere richiamata dalla libreria denominata SUBLIN. 


OLINK PAYROLL, PAYLIB, ,PAYLIB,NIQ,LSC,,SUBLIB 


| PROCEDURA OLPDSAVE 


OLPDSAVE 


| 


La procedura OLPDSAVE copia il supporto diagnostica in linea (OLPD) su minidi- 
sco. ll supporto OLPD è copiato dalla libreria #LIBRARY e dai file #PSPTILT, 
PD1.SCRN, PD1.SCR2 e PD1.CTRL. Se si dispone di unità a nastri e di dispositivi 
di comunicazione vengono anche copiati i file PD2.TAPE, PD2.TAP2, PD2.TCTL, 
PD3.COMM, PD3.COM2 e PD3.CCTL. Il minidisco che dovrà contenere il supporto 
salvato dovrà essere 2D con formato FORMAT? e con ID di volume PPOLDPD. Pri- 
ma di avviare la procedura OLPDSAVE, inserire il minidisco nell’alimentatore. Se 
si usa un caricatore, utilizzare l'alloggiamento 1. 


Per caricare il supporto OLPD dal minidisco di riserva, avviare la diagnostica in linea 


con la procedura PROBLEM. AI momento del caricamento del supporto, vi sarà una 
richiesta per l'inserimento del minidisco OLPD. 


La procedura OLPDSAVE non ha parametri. 


| Esempio 


Copia del supporto OLPD su minidisco. 


OLPDSAVE 


PROCEDURA ORGANIZE 


La procedura ORGANIZE è supportata soltanto per compatibilità con il Siste- 
ma/34 della IBM. Per organizzare un file su disco, vedere la Procedura COPY- 
DATA. Per organizzare un file su disco e salvarlo su minidisco, vedere la Proce- 
dura SAVE, 


PROCEDURA OVERRIDE 


La procedura OVERRIDE è supportata soltanto per compatibilità con il Siste- 
ma/34 della IBM. Vedere la Procedura ALTERCOM per informazioni sulla mo- 
difica delle informazioni di comunicazioni. 
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| PROCEDURA PASSTHRU 


moto dove è possibile effettuare il collegamento come se il terminale fosse collega- 


| La procedura PASSTHRU consente di passare da un sistema su un Sistema/36 re- 
to al Sistema/36 remoto. 


| Per maggiori informazioni su come eseguire la procedura PASSTHRU, vedere il ma- 
nuale Using System/36 Communications. 


PASSTHRU nome ubicazione remota, [rome gruppo sessione | 





| nome ubicazione remota specifica il nome dell'ubicazione remota con cui ci si vuole 
collegare. Questo parametro è necessario. 


nome gruppo sessione specifica il gruppo sessione APPC da usarsi con la stazione 
video-passante. Se si vogliono spazi in bianco per il nome gruppo sessione, de- 
ve essere specificato * BLANK. Se non specificato, viene usato il nome gruppo 
sessione configurato come valore assunto automaticamente. 


| Esempio 

| Questo esempio mostra come passare su un Sistema/36 con nome ubicazione 
CHICAGO. 

| PASSTHRU CHICAGO 


|. PROCEDURA PASSWORD 

L La procedura PASSWORD consente di modificare la parola d'ordine. 
Per maggiori informazioni sulla procedura PASSWORD, vedere il manuale Guida alla 
riservatezza. 
diante parola d’ordine. 


La procedura PASSWORD esegue il programma di utilità $PRPWD. 


| Per poter eseguire la procedura PASSWORD, deve essere attiva la riservatezza me- 





CHANGE specifica che la parola d'ordine deve essere modificata. CHANGE è il va- 
lore assunto e non è necessario specificarlo. 

| Esempio 

I L'esempio mostra come modificare la parola d'ordine. 


| PASSWORD 
358.2 


PROCEDURA PCEXCH 


Con la procedura PCEXCH si possono scambiare dati tra un disco virtuale o un minidisco 
virtuale ed una cartella. Il programma di utilità di supporto file può creare un minidisco 
virtuale sul Sistema/36; il supporto PC/36 può creare un disco virtuale. Dischi virtuali 
0 minidischi virtuali contengono dati da un PERSONAL COMPUTER IBM. 


Per scambiare dati da una cartella a un disco o minidisco virtuale: 


PCEXCH i documento | [none cartella|,[none aisco/minidisco |, 


[none cile), [via d'accesso |. [n NOREPLACE 
REPLACE — 





Per scambiare dati da un disco o minidisco virtuale ad una cartella: 


FINAL 
REVISABLE 


PCEXCH POFILE,| nome aisco/minidisco |, [pone rie]. DATA 


[via d'accessol, STORE [pone documento |, [none cartella |, NOREPLACE 
TEXT REPLACE 


PRINT 


[data conservazione |, [descrizione documento |,| ia stampatrice | 


DOCUMENT specifica che i dati devono essere scambiati da cartella a disco 0 minidisco 
Virtuale. 


NOME DOCUMENTO specifica il documento DW/36 da scambiare. 
NOME CARTELLA specifica la cartella contenente il documento. 


NOME DISCO/MINIDISCO specifica il disco 0 minidisco virtuale che riceverà i dati 
scambiati. 
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NOME FILE specifica il file su disco o minidisco virtuale che conterrà i dati scambiati. 


METODO ACCESSO specifica l'alternativa all'indirizzario principale del disco o minidi- 
sco virtuale in cui il file deve essere listato. Se non è specificato alcun parametro, 
viene assunto l’indirizzario principale. 


NOREPLACE specifica che se esiste già un file con lo stesso nome, verrà inviato un 
messaggio di errore. Se non viene specificato alcun parametro, viene assunto NO- 


REPLACE. 


REPLACE specifica che se già esiste un documento con lo stesso nome, quest’ultimo 
verrà rimpiazzato. 


PCFILE specifica che i dati devono essere scambiati da un disco o minidisco virtuale 
Personal Computer IBM a una cartella. 


NOME DISCO/MINIDISCO specifica il disco o minidisco virtuale che contiene il file. 

NOME FILE specifica il file su disco o minidisco virtuale che deve essere scambiato. 

DATA specifica che il file da scambiare contiene dati. 

FINAL specifica che il file da scambiare contiene un documento finale. 

REVISABLE specifica che il file da scambiare contiene un documento’ revisionabile. 

VIA D'ACCESSO specifica l'alternativa all’indirizzario principale del disco o minidisco 
virtuale in cui il file è listato. Se non viene specificato alcun parametro, viene assun- 
to l'indirizzario principale. 


STORE specifica che il file deve essere memorizzato nel suo formato nel documento 
specificato. 


TEXT specifica che il file deve essere stampato. Se si specifica PRINT, si deve specifica- 
re anche FINAL. 


NOME DOCUMENTO specifica il documento che deve contenere i dati scambiati. 


NOME CARTELLA specifica la cartella che deve contenere il documento. Se non è spe- 
cificato alcun parametro, viene assunta la cartella corrente. 


NOREPLACE specifica che se esiste già una cartella con lo stesso nome, verrà inviato 
un messaggio di errore. Se non viene specificato alcun parametro, viene assunto 
NOREPLACE. 


REPLACE specifica che se già esiste una cartella con lo stesso nome, questa verrà 
rimpiazzata. 


DATA CONSERVAZIONE specifica per quanto tempo il documento deve essere 
conservato. 


DESCRIZIONE DOGUMENTO è la descrizione del documento da creare. La descrizione 
non può essere più lunga di 35 caratteri. 


ID STAMPATRICE specifica l'ID della stampatrice da utilizzare se si specifica PRINT. 
Se non si specifica PRINT, viene utilizzata la stampatrice di sistema. 
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PCU 


| PROCEDURA PCU 


La procedura PCU (Personal Computer Utility) consente di eseguire quanto segue 
utilizzando il PC Supporto/38: 


Creare un disco virtuale 

Cancellare un disco virtuale 

Copiare file e membri origine e di libreria Sistema/36 su un file PC memorizza- 
to su un disco virtuale e facoltativamente convertire i caratteri da ASCII a 


EBCDIC. 


Copiare file PC memorizzati su un disco virtuale su file o membri origine o di 
libreria Sistema/36, e facoltativamente convertire caratteri da ASCII a EBCDIC. 


Copiare file PC memorizzati su un disco virtuale su altri file PC memorizzati sul- 
lo stesso disco virtuale o uno differente. 


Copiare file PC su un documento Display Write/36 (se il Display Write/36 è 
supportato). 


Copiare un documento Display Write/36 su un file PC (se il Display Write/36 
è supportato). 


Modificare la tabella di conversione da ASCII a EBCDIC. 


Modificare la tabella di conversione da EBCDIC a ASCII. 


Per maggiori informazioni sulla procedura PCU, vedere il manuale PC Supporto/36 
Riferimenti tecnici. 


Per creare un disco virtuale: 


VIRTDISK,CREATE, {nome disco virtuale | ; lampiezza disco ; lampiezza indirizzario | | 


[acserizione | 





| Per cancellare un disco virtuale: 


VIRTDISK,DELETE, [rome disco virtuale 





| Per copiare un file disco virtuale su un altro disco virtuale: 








PCU VIRTDISK,DISKDISK, {nome file PC immissione] ; [nome disco virtuale immissione | ; 


[metodo d'accesso | : {nome file PC emissione | , {nome disco virtuale emissione | ; 







[metodo d'accesso |, CREATE |, |NOREADONLY |, {EXCLUSIVE 
REPLACE READONLY SHARE 









| Per copiare un file disco virtuale su un file Sistema/36: 


PCU VIRTDISK,DISKFILE, [nome file PC immissione | i {nome disco virtuale immissione | 2 


[metodo d'accesso | - [nome file 5/36 emissione | , |CREATE i [numero massimo di record | ; 
ADD 
REPLACE 









NOXLATE 


{lunghezza record del fe] ; a | ; i A [sostituzione carattere | 
END 
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| Per copiare un file 5/36 su un file disco virtuale: 






PCU VIRTDISK,FILEDISK, | nome file S/36 immissione ; {nome file PC emissione | ; 





| nome disco virtuale emissione | ; [metodo d'accesso | .| CREATE | ,|NOREADONLY |, 
REPLACE READONLY 








EXCLUSIVE |, | XLATE , |NOEND , osttzione carattere | 
SHARE NOXLATE END 





| Per copiare un file disco virtuale su un membro di libreria 5/36: 
PCU VIRTDISK,DISKLIBR, nome file PC immissione | , nome disco virtuale emissione | ; 


P ADD 


[metodo d'accesso | ; nome membro] iù : [nome libreria] ; ICREATE ; 
| REPLACE 


[anghezza record mermbre , | XLATE , INOEND |, [sostituzione carattere | 
NOXLATE END 





I Per copiare un membro di libreria S/36 su un file disco virtuale: 


PCU VIRTDISK,LIBRDISK, Î nome membro | ; [8] ; [nome ibrezia : Î nome file PC emissione }: 
P 








Î nome disco virtuale emissione | î [metodo d'accesso | , | CREATE , [NOREADONLY |, 
ADD READONLY 
REPLACE 
























EXCLUSIVE |, {XLATE , [NOEND postazione carattere | 
SHARE NOXLATE END 
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Per copiare un file disco virtuale su un documento Display Write/36 (se il Display 
Write/36 è supportato): 


| PCU VIRTDISK,DISKDOC 





Per copiare un documento Display Write/36 su un file disco virtuale (se il Display 
Write è supportato): 


| PCU VIRTDISK,DOCDISK 





Per modificare la tabella di conversione da ASCII a EBCDIC: 


PCU VIRTDISK,ASCII 
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PCU 
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| Per modificare la tabella di conversione da EBCDIC a ASCII: 


VIRTDISK, EBCDIC 





CREATE specifica di voler creare un disco virtuale con le opzioni CREATE e DISKDISK. 
CREATE specifica che non è necessario che esista il file Sistema/36 per copia- 
re il file di dati con le opzioni DISKFILE e DISKLIBR. 
Ì DELETE specifica che si vuole cancellare un disco virtuale. 


| DISKDISK specifica che si vuole copiare u file disco virtuale su un altro file disco 
virtuale. 


DISKFILE specifica che si vuole copiare un file disco virtuale su un file Sistema/36. 
FILEDISK specifica che si vuole copiare un file Sistema/36 su un disco virtuale. 


DISKLIBR specifica che si vuole copiare un file disco virtuale su un membro di libre- 
ria S/36. 


LIBRDISK specifica che si vuole copiare un membro di libreria Sistema/36 su un di- 
sco virtuale. 


splay Write/36. 


DOCDISK specifica che si vuole copiare un documento Display Write/36 su un di- 


| DISKDOC specifica che si vuole copiare un file disco virtuale su un documento Di- 
| sco virtuale. 


| ASCII specifica che si vuole modificare la tabella di conversione ASCII-EBCDIC. 


Î EBCDIC specifica che si vuole modificare la tabella di conversione EBCDIC-ASCII. 


| ampiezza disco specifica la capacità del nuovo disco virtuale in kbyte. 
ampiezza dizionario specifica il massimo numero di file o sottoindirizzari che posso- 
no essere contenuti in una radice di indirizzario. 
descrizione specifica una descrizione che non può superare 40 caratteri. Può con- 
tenere qualsiasi carattere tranne un apostrofo. 
nome disco virtuale specifica il nome del disco virtuale che si vuole creare, cancel- 
lare, copiare su o copiare da. i 


I nome file PC immissione specifica il nome del file PC da copiare. 


nome disco virtuale d’'immissione specifica il nome del disco virtuale che contiene 
l'immissione. : 

| nome file $/36 d’'immissione specifica il nome del file $/36 da cui si deve copiare. 

| nome file PC di emissione specifica il nome del file PC che deve ricevere la copia. 


nome disco virtuale d'emissione specifica il nome di un disco virtuale esistente che 
dovrà ricevere il file copiato. 


ZEN 


nome file $/36 d'emissione specifica il nome da dare al file S/36 che conterrà i dati 
copiati dal Personal Computer. 


metodo d'accesso specifica il nome di uno o più sottoindirizzari. 


READONLY specifica che si vuole che i programmi PC abbiano un livello di accesso 
di lettura solo sul file disco virtuale. 


NOREADONLY specifica che si vuole che i programmi PC possano scrivere o ag- 
giungere dati sul file disco virtuale. 


EXCLUSIVE specifica che non si vuole che altri utenti leggano dal disco virtuale du- 
rante la copia dello stesso. 


SHARE specifica che si vuole che altri utenti leggano dal disco virtuale durante la 
copia dello stesso. 


ADD specifica che il file 5/36 che si sta copiando deve esistere e che si vogliono 
aggiungere dati dopo la fine del file dati esistente. 


REPLACE specifica che il file 5/36 o file disco virtuale su cui si effettua la copia 
con lo stesso nome, sarà sostituito dal file S/36 o file disco virtuale di 
immissione. 


numero massimo di record specifica il numero massimo di record che può contene- 
re il file S/36. 


lunghezza record del file specifica la lunghezza dei record da copiare sul file dati 
Sistema/36. 


XLATE specifica che si vogliono convertire i dati da ASCII a EBCDIC o da EBCDIC 
a ASCII, 


NOXLATE specifica che non si vogliono convertire i dati da ASCII a EBCDIC o da 
EBCDIC a ASCII. 


NOEND specifica che si vogliono sostituire con caratteri sostitutivi tutti i caratteri 
non convertibili. 


END specifica che si vuole interrompere la funzione di copia non appena viene tro- 
vato un carattere non convertibile. Viene inviato un messaggio di errore. 


carattere sostitutivo specifica il carattere sostitutivo da usarsi quando viene trova- 
to un carattere non convertibile. 


nome membro specifica il nome del membro di libreria di immissione o di emissione. 
S specifica che si vuole un membro origine di libreria. 

p specifica che.si vuole un membro procedura di libreria. 

nome libreria specifica la libreria contenente il membro di libreria. 


lunghezza record membro specifica la lughezza dei record da copiare nel membro 
di libreria. Può essere da 40 a 120. 
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Esempio 


| : Questo esempio mostra come avviare la procedura PCU per lavorare con i dischi 
virtuali. 


| PCU. 


| Viene visualizzato un menù e si può scegliere una delle opzioni elencate nel menù. 


358.10 


PROCEDURA POST 


La procedura POST copia su file su disco i file su minidisco in formato speciale 
E. 1 minidischi in formato speciale E sono creati dal IBM 5260 Retail System. 
La procedura POST può anche: 


#e Copiare un file su minidisco in formato speciale E o formato base di interscambio 
su un file su disco a indice o sequenziale. 


e Aggiungere un file su minidisco in formato speciale E o formato base di interscam- 
bio ad un file su disco sequenziale esistente. 


e Copiare un file su disco su un file su minidisco in formato base di interscam- 
bio. 


e Aggiungere record da un file su disco a un file su minidisco in formato base 
di interscambio. 


Per informazioni sul formato base di interscambio, vedere la Procedura TRAN- 
SFER. 


Poichè POST elabora soltanto file su minidisco in formato speciale E o in forma- 
to base d’interscambio, il minidisco usato per ricevere l'emissione POST deve 
essere inizializzato in uno dei seguenti formati: 


e Un minidisco 1 (unilaterale) inizializzato in formato a 128 byte per settore, 


e Un minidisco 2D (bilaterale doppia densità), inizializzato nel formato a 256 
byte per settore. 


Se il formato del minidisco non è noto, è possibile usare la procedura CATALOG 
per listare la VTOC del minidisco. La lista mostra se il minidisco è stato inizializ- 
zato nel formato a 128, a 256, 512 o 1024 byte. Vedere la Procedura CATA- 
LOG. 


Quando un file su minidisco in formato speciale E viene copiato su un file su 
disco sequenziale o a indice, i record sono inseriti nel file su disco sequenziale, 
usando la lunghezza di record del file su minidisco, Quando deve essere aggiunto 
un file su minidisco formato speciale E a un file su disco sequenziale esistente, 
i record nel file su minidisco sono troncati o riempiti con zeri (x’'00’) per confor- 
marsi alla lunghezza di record del file su disco. 


Quando un file su disco diretto a indice o sequenziale viene copiato su un file su 
minidisco in formato base di interscambio, la lunghezza di record dei file su mi- 
nidisco è impostata al valore più piccolo tra la lunghezza di record del file su 
disco, 128 (per minidisco 1) o 256 (per minidisco 2D). Per esempio, se si stesse 
copiando un file su disco sequenziale con una lunghezza di record di 300 su un 
minidisco 2D, la lunghezza di record del file su minidisco in formato base d’inter- 
scambio, sarebbe 256 e le posizioni di record da 257 a 300, verrebbero troncate. 


La procedura POST esegue il programma di utilità $POST, 
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Per copiare un file su minidisco in formato speciale E o formato base di interscambio 
su un nuovo file su disco a indice o sequenziale: 


nome file immissione » |]. mnggaa ,|noapD], |. 


egnmaa lanelizzza chiave, 
aammgg 


posizione chiave 


ù Sl , |AUTO NOEOD NODUPKEY 
RECORDS,record NOAUTO EOD DUPKEY 
BLOCKS, blocchi 





Per aggiungere un file su minidisco formato speciale E o formato base di interscambio 
a un file su disco sequenziale esistente: 


nome file immissione, [11] simmggaa|, ADD,jnome file emissione |, aatal 3 


gemmaa nome file immissione 
s|AUTO |, |NOEOD 
NOAUTO EOD 





aammgg 





Per copiare un file su disco su un nuovo file su minidisco in formato base di in- 
terscambio: 


nome file immissione,Fl,|mmggaa |, id volume,)giorni ai validità 
aggmmaa PA 
aammgg 


993 


AUTO 
NOAUTO 
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Per aggiungere un file su disco ad un file su minidisco esistente in formato base 
di interscambio: 


nome file immissione,Fl1,|mmegaa|,id volume,|giorni ai validità 
gemmaa L 
aammeg 


ADD,|nome file emissione |,| Sl , |AUTO 
nome file immissione S2 NOAUTO 


S3 
Ml.nn 
M2.nn 





nome file immissione specifica i! file da copiare. Se viene creato un nuovo file, gli 
viene attribuito il nome specificato da questo parametro. 


I1 specifica che un file su minidisco viene copiato su un file su disco a in- 
dice o sequenziale. Se questo parametro non viene specificato, si pre- 


sume 11. 


F1 specifica che un file su disco iene copiato su un file su minidisco in formato 
base di interscambio. 


mmggaa, ggmmaa o aammgg specifica la data di creazione del file che viene co- 
piato. La data se specificata deve essere nel formato della data di sessione; 
usare il comando STATUS SESSION per determinare il formato della data 
di sessione. Se sul disco risiede più di un file con il nome specificato e non 
viene specificata alcuna data, il file col nome specificato con una data più re- 
cente viene copiato sul minidisco, 


NOADD specifica che il file su minidisco viene trasferito per diventare un nuo- 
vo file su disco a indice o sequenziale con il nome specificato dal nome 
file di immissione. Se non viene immesso alcun parametro, si presume 


NOADD. 


lunghezza chiave, posizione chiave specifica che deve essere creato un file a indi- 
ce. Se questi vengono omessi, viene creato un file sequenziale. 


lunghezza chiave specifica la lunghezza di chiave per il file a indice su disco 
che deve essere creato. La lunghezza di chiave può essere qualsiasi numero 


da 1 a 120. 
posizione chiave specifica la posizione iniziale della chiave nel record. La po- 


sizione di chiave può essere qualsiasi numero da 1 a 128 per il minidisco 1 
o da 1 a 256 per il minidisco 2D. 
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RECORDS o BLOCKS specifica la dimensione del file. Se non viene specificato 
RECORDS o BLOCKS, la dimensione del file su minidisco è usata come di- 
mensione del file su disco. RECORDS o BLOCKS devono essere specificati se: 


e li file su minidisco si trova su più di un minidisco. 


è Ji file su disco creato deve essere più grande del file che viene copiato. 


RECORDS specifiche che il file su disco che viene creato deve essere ampio 
a sufficienza per contenere il numero di record specificato. 


record specifica il numero di record da allocare per il file su disco. Può esse- 
re specificato qualsiasi numero da: 1 a 8.000.000. 


BLOCKS specifica che il file su disco che viene creato deve essere sufficiente- 
mente ampio per contenere il numero di blocchi specificato. 


blocchi specifica il numero di blocchi da allocare al file su disco. Può essere 
specificato qualsiasi numero da 1 a 312.815. 


ADD specifica quanto segue: 


e Se viene specificato 11, ADD specifica che i record nel file su minidisco 
devono essere aggiunti ai record in un file su disco sequenziale 
esistente. 


e Se viene specificato F1, ADD specifica che i record in un file su disco 
devono essere aggiunti ai record in un fiie su minidisco in formato base 
d’interscambio esistente. ll primo record del file su disco è disposto 
dopo l’ultimo record nel file su minidisco. 


nome file emissione specifica quanto seque: 


e Se viene specificato I1 il nome file di emissione specifica il file su disco 
esistente al quale deve essere aggiunto il file su minidisco. 


e Se viene specificato F1, il nome file di emissione specifica il file esisten- 
te su minidisco al quale deve esssere aggiunto il file su disco. 


HI nome del file di emissione è ammesso soltanto se viene specificato ADD. 
Se non è specificato alcun nome file di emissione, si presume il nome file di 
immissione, 


data specifica la data di creazione del file su disco esistente. La data è valida sol- 
tanto se viene specificato ADD. La data deve essere specificata nello stesso 
formato della data di sessione. 


id volume specifica l'ID di volume per il minidisco. E’ possibile specificare da 1 a 
6 caratteri alfanumerici. Il parametro ID di volume indica che deve essere 
creato da un file su disco un file su minidisco in formato base d’interscambio. 


giorni di validità specifica la lunghezza del periodo di validità in giorni per il file 
su minidisco. Se non è specificato alcun periodo di validità, si presume un 
giorno. Se è specificato un periodo di validità di 999 giorni, il file su minidi- 
sco è considerato file permanente. Per ulteriori informazioni sulla validità dei 
file su minidisco, vedere la Specifica OCL FILE {per i file su minidisco). 


S1, S2 o S3 specifica l'alimentatore a minidischi contenente il primo minidisco 
dal quale i membri devono essere elaborati. Se non è specificato alcun para- 
metro si presume S1. 


M1.nn o M2.nn specifica fa locazione del caricatore contenente il primo minidi- 

sco dal quale i membri devono essere elaborati. M1 indica il primo caricatore 

e M2 indica il secondo. nn è un numero da 01 a 10 che identifica la locazio- 

sa ne del minidisco nel caricatore. Specificare M1 equivale a specificare M1.01. 
Specificare M2 equivale a specificare M2.01. : 


AUTO specifica quanto segue: 


e Se vengono specificati S1, $2 o $S3, possono essere usati tutti e tre i sin- 
goli alimentatori (S1, S2 e S3). L'elaborazione inizia con il minidisco 
nell'alimentatore specificato e continua fino al minidisco nell'alimentato- 
re S3. Se occorrono altri minidischi, viene visualizzato un messaggio e 
l'operatore deve quindi inserire i successivi minidischi. L'elaborazione ri- 
prende col minidisco nell’alimentatore S1. 


e Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli 
alimentatori del caricatore {M1 e M2). L'elaborazione inizia con il mini- 
disco nella locazione specificata e continua fino al minidisco nella loca- 
zione M2.10. Se occorrono altri minidischi, viene visualizzato un messag- 
gio e l'operatore deve inserire i successivi caricatori. L'elaborazione ri- 
prende alla locazione M1.01. 


Se non è specificato alcun parametro, si assume AUTO. 
NOAUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, può essere usato soltanto l'alimentatore 
specificato. Se occorrono altri minidischi, viene visualizzato un messaggio 
e l'operatore deve inserire il successivo minidisco nell’alimentatore speci- 
ficato. 


— e Se viene specificato M1.nn o M2.nn, può essere usato soltanto il carica- 
tore specificato. L'elaborazione inizia con il minidisco nella locazione 
specificata e continua fino all'ultimo minidisco nel caricatore. Se occor- 
rono altri minidischi, viene visualizzato un messaggio e l'operatore deve 
inserire il successivo caricatore nell'alimentatore di caricatore che viene 
usato. L'elaborazione riprende alla prima locazione nel caricatore. 


NOEOD specifica che la condizione speciale di fine dati {vedere la nota che se- 
gue), non deve essere rilevata quando viene copiato un file su minidisco in 
formato speciale E o aggiunto ad un file su disco. Se non viene specificato 
OED o NEOD, si presume la condizione NOEOD. 


Nota: il IBM 5260 Retail System indica la condizione di fine dati con un re- 
cord in bianco. Se viene specificato EOD quando viene copiato un file su mi- 
nidisco in formato base di interscambio, i dati possono andar persi. 


EOD specifica che la condizione speciale di fine dati (vedere nota che precede), 
deve essere rilevata quando viene copiato o aggiunto un file su disco o un 
file su minidisco in formato speciale E. 


DUPKEY specifica che nel file a indici che viene creato, devono essere ammesse 
chiavi doppie. Se il file che viene creato non è a indici, questo parametro è 
ignorato. Se questo parametro non viene specificato, l'attributo del file di 
immissione è identico all’attributo del file di emissione. 


NODUPKEY indica che nel file a indici che viene creato, le chiavi doppie non 
sono ammesse. Se il file che viene creato non è a indici, questo parametro 
è ignorato. Se questo parametro non è specificato, l'attributo del file di im- 
(228 missione è identico all’attributo del file di emissione. 
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Esempio 1 


Questo esempio mostra come creare un file su disco a indice denominato FILE2 
{con la chiave nelle posizioni da 1 a 4), partendo da un file su minidisco in for- 
mato speciale E denominato FILE2 e controllare la condizione speciale di fine 
dati. 


POST FILE2,,,,4,1,3»,EOD 


Esempio 2 


Questo sempre mostra come aggiungere un file su minidisco in formato speciale 
E denominato FILE1 a un esistente file su disco denominato FILE1, 


POST FILEl,, ADD 


PROCEDURA PRINT 


La procedura PRINT specifica ie seguenti informazioni sulla stampatrice da usare 
durante una sessione all'unità video a meno che non venga indicato un !D di 
stampatrice specifico in un lavoro. 


e L’ID della stampatrice da usare per tutte le emissioni su stampa create du- 
rante la sessione all'unità video. 


e ll numero di righe da stampare per pagina. 

e La densità verticale di stampa (righe per pollice). 

e La densità di stampa orizzontale (caratteri per pollice). 

e Il numero di modulo. 

Un lavoro inserito nella coda lavori usa i valori che erano in atto quando il lavoro 
è stato inserito nella coda. In ogni caso se la procedura che viene eseguita dalla 
coda lavori contiene una procedura PRINT, in essa vengono usati i valori impo- 


stati dalla procedura PRINT. 


La procedura PRINT elabora una specifica OCL FORMS. 


SYSTEM 


id stampatrice , righe per pagine |, [rigne per pollice n 


[caratteri per pollice| , [numero nodulo] 


Quantunque tutti i parametri siano facoltativi, deve esserne specificato almeno 
uno. Qualsiasi parametro che viene omesso fa sì che le corrispondenti regolazioni 
rimangono invariate. 


id stampatrice o SYSTEM specifica fa stampatrice da usare per l'emissione stam- 
pata. Tutta l'emissione di lista del sistema, l'emissione del tasto STAMPA 
(salvo dove diversamente indicato dalla procedura PRINTKEY) e qualsiasi al- 
tra emissione stampata dalla sessione, viene stampata sulla stampatrice speci- 
ficata. La specifica OCL PRINTER può essere usata per specificare una stam- 
patrice diversa per l'emissione del programma, Se non viene specificato alcun 
parametro, le stampatrici non vengono modificate. 


id stampatrice specifica l'ID di terminale delia stampatrice da usare. E’ possi- 
bile usare il comando STATUS WORKSTN per determinare gli ID di stampa- 
trice. ” 


SYSTEM specifica che deve essere usata la stampatrice di sistema. 
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righe per pagina specifica il numero di righe di stampa per pagina. il numero mas- 


simo di righe che può essere specificato per pagina è 112. Questo numero è 
determinato moltiplicando la regolazione righe per pollice per l'altezza della 
carta. Per esempio, se la carta è alta 11 pollici e le righe per pollice sono 6, 
la regolazione righe per pagina deve essere 66 (11 x 6 = 66). Il valore di ri- 
ghe per pagina rimane in atto fino a che la sessione termina oppure non 
viene specificato un nuovo valore di righe per pagina: 


e Da un'altra procedura PRINT 

® Dalla procedura LINES 

e Dalla specifica OCL PRINTER (solo per quel file di stampa) 
e Dalla specifica OCL FORMS 

e Dalla procedura SET o dal programma di utilità $SETCF 


Se non viene specificato alcun parametro e il numero di righe per pagina non 
era stato precedentemente impostato durante la sessione, il sistema usa il va- 
lore specificato per l’unità video durante fa configurazione del sistema ad 
opera delja procedura SET o ad opera del programma di utilità $SETCF. 


Per i programmi forniti dalla IBM e per la maggior parte dei programmi scrit- 
ti dagli utenti, la stampatrice salta ad una nuova pagina quando mancano 6 
righe al valore di righe per pagina specificato. Per esempio, se viene specifica- 
to 66 la stampatrice salta ad una nuova pagina dopo la stampa della riga 60. 
Inoltre, la stampatrice inizia alla riga 6 della nuova pagina. Pertanto se si 
specifica 66 si ottengono in realtà 54 (66 — 12 = 54) righe per pagina. Se 
viene specificato 13 viene stampata una riga per pagina. Quando sono speci- 
ficate 12 righe o meno, la stampa si verifica su ogni riga di ciascuna pagina, 


Per le operazioni di stampa dai propri programmi, il SSP indica una condi- 
zione di eccedenza quando vengono stampate 6 righe in meno di quelle spe- 
cificate (nel programma o nella procedura PRINT). 


righe per pollice specifica la densità verticale di stampa (righe per pollice) da usa- 


re per l'emissione stampata datla sessione di unità video. | valori che possono 
essere specificati sono 4, 6 e 8. Se l'emissione è stampata su una stampatrice 
che non supporta la densità verticale di stampa, il valore righe per pollice viene 
ignorato. 


l valore righe per pollice rimane valido fino a che la sessione termina o non 
viene specificato un nuovo valore righe per pollice: 

e Da un'altra procedura PRINT 

e Dalla procedura LINES 

e  Dauna specifica OCL PRINTER (per quel file di stampa soltanto). 

e Dauna specifica OCL FORMS. 


Se non è specificato alcun valore di righe per pollice e tale valore non era 
stato precedentemente impostato durante la sessione, il sistema usa il valore 
impostato al momento della configurazione della stampatrice (4, 6 o 8). Se 
anche in tale occasione non era stato specificato alcun valore, la stampatrice 
usa la regolazione prevista sulla macchina {l'interruttore di densità di stampa) 
e questo parametro viene ignorato. 


caratteri per pollice specifica la densità di stampa orizzontale (cioè i caratteri per 
pollice) da usare per l'emissione stampata della sessione di unità video. | va- 
lori che possono essere specificati sono 10 o 15. La stampatrice da usarsi de- 
ve supportare la densità di stampa orizzontale specificata. Se il valore specifi- 
cato non è supportato dalla stampatrice viene visualizzato un messaggio e l'o- 
peratore che controlla la stampatrice può continuare a cancellarre il lavoro. 


Il valore caratteri per pollice rimane valido fino a che la sessione termina o 
non viene specificato un altro valore: 


e Da un'altra procedura PRINT 


Dalla procedura LINES 


e Dauna specifica OCL PRINTER (solo per quel passo di stampa). 
e Da una specifica OCL FORMS 


Sè non viene specificato caratteri per pollice e tale parametro non era stato 
precedentemente impostato durante Ja sessione, il sistema usa il valore defini 
to in occasione della configurazione della stampatrice (10 o 15). Se anche in 
tale occasione non era stato specificato alcun valore, la stampatrice usa la 
regolazione in atto sulla macchina (l'interruttore di densità di stampa) e que- 
sto parametro viene ignorato. 


numero modulo specifica il numero modulo dei moduli di stampatrice da usare 
per l'emissione stampata dalla sessione all'unità video. (Ciascun tipo di modu- 
lo deve avere un proprio numero esclusivo assegnato dall'utente). Il numero 
di modulo può essere qualsiasi combinazione di caratteri con un massimo di 
4, salvo le virgole (,), gli apici (’) e gli spazi in bianco. | punti di domanda 
(?), le barrette (/), i segni di uguale (=), i segni di maggiore (>), i segni più 
{+) ei trattini di divisione sillabica (-), devono essere usati con cautela in quanto 
hanno significati speciali nell’ambito delle procedure. 


Se viene specificato un numero di modulo, all'operatore che controlia la 
stampatrice è richiesto di installare nella stampatrice i moduli con il numero 
specificato, se questi non sono già installati. 


if numero di modulo rimane valido fino a che la sessione termina o non vie- 
ne specificato un nuovo numero di modulo: 


e Da un'altra procedura PRINT 
e Dalla procedura LINES 
e Da una specifica OCL PRINTER (solo per quel file di stampa). 


e Da una specifica OCL FORMS 
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Esempio 1 


La seguente procedura specifica che deve essere usata la stampatrice con un ID di 
P3 per l'emissione stampata durante la sessione. 


PRINT P3 


Esempio 2 
La seguente procedura specifica che il numero di righe per pagina da usare è 51. 


PRINT. ,5l 


Esempio 3 


La seguente procedura specifica che deve essere usata una stampatrice con un ID 
di stampatrice P2 per l'emissione stampata durante la sessione. L'operatore desi- 
dera che l'emissione stampata venga battuta a 8 righe per pollice e a 15 caratteri 
per pollice. Poichè i moduli installati nella stampatrice sono lunghi 11 pollici {27,9 
cm), il numero di righe per pagina è 88. 


PRINT 2,88,8,15 
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PROCEDURA PRINTKEY 
La procedura PRINTKEY consente di specificare quanto segue: 


e La stampatrice da usare per l'emissione del tasto STAMPA . 


e Se deve essere stampato un margine intorno all'immagine video. Ciò può es- 
sere utile per documentare gli schermi, 


e Se deve essere stampato un titolo prima dell'immagine video. Ciò può essere 
di aiuto per determinare la provenienza della richiesta di stampa quando non 
vengono stampati separatori di pagina. 


Le: modifiche effettuate con la procedura PRINTKEY rimangono valide durante 
la sessione fino a che non vengono cambiate da un’altra procedura PRINTKEY, 
dalla procedura SET, dalla procedura PRINT o dalla specifica OCL WORKSTN. 


La procedura PRINTKEY esegue il programma di utilità $SETCF. 


PRINTKEY lia stampatrice]| ,|BorDER |, {HEADER 


NOBORDER NOHEADER 





Quantunque tutti i parametri siano facoltativi, deve esserne specificato almeno 
uno. Qualsiasi parametro che viene omesso, fa sì che la regolazione corrisponden- 
te rimanga invariata. 


id stampatrice specifica l'ID di terminale della stampatrice da usare per stampare 
l’immagine delio schermo mentre l'operatore preme il tasto Print. Il comando 
STATUS WORKSTN, può essere usato per determinare gli ID di stampatrice. 


BORDER specifica che deve essere stampato un margine intorno all'immagine 
dello schermo, La Figura 22 mostra l’immagine di uno schermo campione 
con un margine. 


NOBORDER specifica che non deve essere stampato alcun margine intorno al- 
l'immagine dello schermo. 


HEADER specifica che deve essere stampato un titolo al di sopra della immagine 
dello schermo. La Figura 22 mostra l’immagine di uno schermo campione 


con un margine. 


NOHEADER specifica che non deve essere stampato un titolo al di sopra dell’im- 
magine dello schermo. 
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Esempio 1 


Questo esempio mostra come ottenere un margine stampato intorno agli schermi 
quando si preme il tasto Print. 


PRINTKEY ,BORDER 


Esempio 2 


ol 
02 
03 
ok 
05 
06 
07 
08 
09 
10 
11 


13 
1h 
15 
16 
17 
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19 
20 
21 
22 
23 
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Questo esempio mostra come ottenere un margine e un titolo stampati e come 
far sì che l'emissione stampata vada alla stampatrice PA. 


PRINTKEY Pl, BORDER, HEADER 


ed De RR al SE SR RD e E E RR RR RE RR Re e dl AR HZ Ve El le le e de lE ll e e lt e le e dl A Se Al Re Ae e HR dd de de ded See de de 


xk xk 
*% TASTO STAMP DA-W2 DA UTENTE-SET 12/09/83 12.33.26 v* 
*k xx 


CLITAIZIZZILI ZLI ZI I LIZ:T:ZITZZ: ZITLIZ:ITTTIIIZ:::ZiIZz3:}I:}:}:}: i Z}AziLi: XL A LALA LELLA 


O + 1 + 2 + 3 + ù + 5 + 6 + T + 8 
1 + o) + 0 + 0 + 0 + (o) + lo) + O + ‘o 
PAIA LA SIIZIZI ZIO LIIZIZI LI LI LE TLELETLLLICIIIIIISIAIIIII III III III III IALIA LI 


MAIN W2* 
SISTEMA/36 — Menîù principale di ausilio 
Scegliere una delle opzioni; 


1. Visualizzazione menù utente 

2. Esecuzione attività generali del sistema 

3. Uso e controllo stampatrici, minidischi o nastro 

l. Uso e gestione librerie o file di dati 

5. Uso linguaggi di programmazione e programmi di utilità 
6. Comnicazioni con altri sistemi o utenti 

T. Definizione del sistema e dei relativi utenti 

8. Diagnostica e manutenzione 

9. Scollegamento del sistema 


CMD3-Menù precedente CMDT-Fine CMD12-Inform. ausilio Rit curs-Menù colleg. 


Immettere numero opzione o comando 


IEEE O E E E E E E E N E E E E 0 O 
TOO E E O E E E O E E OE O E E E E 


(c) 1983 IBM Corp. 
lndotototozo iii III TIZI LI ZII LZILZILSI ZI ASI TITTI III FIT XXXII TI: XIITKEI Xi tt td 
O + 1 + 2 + 3 + pi + 5 + 6 + T + 8 
1 + (0) + (0) + (o) + 0 + (6) + (o) + (o) + 0 


Figura 23. Emissione campione del tasto Stampa con titolo e margine 
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PROBLEM 


PROCEDURA PROBLEM 


La procedura PROBLEM avvia le procedure della diagnostica in linea (OLPD). La pro- 
cedura PROBLEM deve essere eseguita dalla console di sistema sull’ubicazione del 
sistema. 


Se la console di sistema era stata assegnata ad un’altra stazione video, si dovrà 
usare i comandi CONSOLE GIVE e CONSOLE TAKE per ripristinare la console di 
sistema. 


L’OLPD potrebbe richiedere all'operatore di eseguire aicune attività durante il corso 
della diagnostica in linea. Queste attività potrebbero essere: montare un nastro 0 
minidisco, impostare un modem su autoprove o inserire un connettore autoprove 
in un cavo. Sugli schermi dell'OLPD sono fornite guide per l'operatore che esegue 
le attività. Le guide contengono grafici che spesso non sono visualizzabili su un DHCF 
{Distributed Host Command Facility) o su altre unità 3270. 


La procedura PROBLEM non ha parametri. 


Esempio 


Questo esempio mostra come avviare le procedure per diagnostica in linea dei 
problemi. 


PROBLEM 
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PROCEDURA ORY 


La procedura QRY richiama il QUERY/36 per permettere di produrre prospetti diversi 
utilizzando i dati dei file. Il QUERY in se stesso è una domanda ed il prospetto creato 
è la risposta alla domanda. 
Si può creare una nuova domanda, e revisionare, copiare, cancellare ed eseguire 
una domanda esistente. Un prospetto QUERY può essere visualizzato o stampato. 
| Si può anche stampare una definizione QUERY. Si possono selezionare e scegliere 
i dati nel prospetto ed eseguire operazioni aritmetiche. Si può inoltre scrivere l’e- 
missione QUERY su un file. 


Per maggiori informazioni vedere l'informazione in linea sul PS/36. 
Per leggere l'informazione in linea: 


e Eseguire la procedura READINFO. Per PS/36 specificare: 
READINFO #0FCDOC,#0FCLDR 
e Scegliere l'opzione 11 dal menù di utilizzo PS/36 


* Premere il tasto di ausilio da qualsiasi schermo PS/36. 


QRY 


La procedura ORY non ha parametri. 
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QRYLOAD 


PROCEDURA ORYLOAD 


La procedura ORYLOAD crea una libreria denominata #ORYLIB e vi copia il supporto 
QUERY/36 da minidisco. Supporti addizionali vengono copiati nella libreria di sistema 
(#LIBRARY), Può copiare sia minidischi PID (Centro distribuzione IBM) che minidischi 
creati dalia procedura ORYSAVE. Vedere la procedura ORYSAVE per informazioni su 
come salvare il supporto QUERY/36 su minidisco. 


La procedura ORYLOAD potrebbe modificare il record principale di configurazione. Con 
conseguente discordanza con il membro di configurazione. Per modificare il membro 
di configurazione vedere il manuale MODIFICA DELLA CONFIGURAZIONE DEL SISTE- 


MA. Si dovrà utilizzare la-procedura CNFIGSSP per aggiungere supporto al sistema. Si 


può utilizzare la procedura ORYLOAD per ripristinare il supporto che era stato salvato 
con le procedure ORYSAVE. 


Se il Query/36 non è in uso corrente sul sistema, è necessario utilizzare la procedu- 
ra TOLIBR per copiare il file minidisco QRY nella libreria # LIBRARY prima di esegui- 
re ORYLOAD. 


se # LIBRARY con il QUERY/36 erano state salvate e poi ripristinate prima di ese- 
PA non è necessario copiare il file minidisco QRY con la procedura 





A1, A2, A3 o A4 indica la preferenza del disco; cioè l'unità disco che viene esaminata 
per prima nella ricerca di spazio disponibile. Se su quell’unità non è disponibile spa- 
zio a sufficienza, vengono esaminate le altre unità (se esistono) e #ORYLIB viene 
inserito sull'unità disco meno usata. Se non è specifica alcuna locazione ed il siste- 
ma dispone di più di un'unità disco, la #ORYLIB è inserito sull'unità disco meno usata. 


A1 specifica che # ORYLIB deve essere inserito sul primo disco, se c'è spazio di- 
sponibile. 


A2 specifica che #QORYLIB deve essere inserito sul secondo disco, se c'è spazio 
disponibile. 


A3 specifica che # ORYLIB deve essere inserito sul terzo disco, se c'è spazio di- 
sponibile. 


A4 specifica che #ORYLIB deve essere inserito sul quarto disco, se c'è spazio di- 
sponibile. 


S1, S2 o S3 specifica l'alimentatore a minidischi contenente il primo minidisco da 
‘usare. Se non è specificata alcuna posizione di minidisco, si presume S1. 


M1.nn o M2.nn specifica la locazione del caricatore che contiene il primo minidisco da 
usare. M1 indica il primo caricatore e M2 indica il secondo. nn è un valore decimale 
da 01 a 10 che identifica la locazione del minidisco nel caricatore. Specificare M1 
equivale a specificare M1.01. Specificare M2 equivale a specificare M2.01. 
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Esempio 
..Creazione.di :# QRYLIB su-disco e copia del :supporto QUERY/36 da :minidisco. 


| QRYLOAD 


PROCEDURA ORYRUN 
La procedura ORYRUN esegue una QUERY che era già stata definita ed invia il prospetto 
prodotto all'unità specificata. Si può anche visualizzare un dato in un file senza definire 
una QUERY. 


Per maggiori informazioni sul QUERY/36 vedere l'informazione in linea. 
Per leggere l’informazione in linea: 


e Eseguire la procedura READINFO, Per il QUERY/36 specificare: 
READINFO #OFCDOC,#OFCLDR 

® Scegliere l'opzione 11 sui menù di utilizzo QUERY/36 

e Premere il tasto di ausilio su qualsiasi schermo QUERY/36. 


Per eseguire una QUERY e visualizzare un prospetto: 


RECSEL 


QRYRUN nome query, [rome ibrerie| î [nome ft] «DISPLAY ,,,,,,,11 gl ; 


DETAIL 
SUMMARY 





Per eseguire una QUERY e stampare un prospetto: 






QRYRUN nome query , [pome ibreria : [rome tie] «PRINTER, [ia stampatrie| ; 





[rghezza molo] i [spezitura inse | ) [copie] ] [numero moduli] sn INOPRINT| , 
PRINT 






NORECSEL |, {DETAIL 
RECSEL SUMMARY 





Per eseguire una QUERY ed inviare l'emissione su disco. 


ORYRUN nome query , [nome jipreria | } [nome i | ,DISK,.,,,, [nome file emissione | : 


NEW ; INOPRINT |, [NORECSEL |, 
REPLACE PRINT RECSEL 
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371.5 





Per visualizzare dati in un file senza definire una QUERY: 


QRYRUN ,,nome sa l Er | 


RECSEL SUMMARY 





CN 


| Per stampare un prospetto senza definire una QUERY: 


QRYRUN ., home file PRINTER, [o stampati : sgh modo ; [sazia nce . [cone ; 





[ numero modi | i» | NOPRINT | , | NORECSEL |, | DETAIL 
PRINT RECSEL SUMMARY 


| Per inviare l'emissione su disco senza definire una QUERY: 


REPLACE PRINT RECSEL 


QRYRUN ,DISK,,,.,, [nome file emissione |, NEW È NOPRINT |, Ea 





NOME QUERY specifica la query che deve essere eseguita: questa deve essere definita 
in precedenza. Se non viene specificato alcun parametro, si deve specificare il no- 
me del file. 


NOME LIBRERIA specifica la libreria che contiene la QUERY da eseguire. Se non viene 
specificato alcun parametro, viene assunta la libreria in uso. 


NOME FILE specifica il file su disco da consultare. Il file deve essere collegato alla stessa 
definizione file come il file specificato quando la QUERY fu definita. Se non viene 
specificato alcun parametro, viene assunto il file specificato al momento della defi- 
nizione della QUERY. Se è specificato un nome file e non un nome QUERY e 
il file è collegato alla definizione, il dato nel file è visualizzato, stampato o spe- 
dito su disco. 


DISPLAY PRINTER, o DISK specifica dove deve essere inviato il prospetto, o l'emissio- 
ne prodotta dalla QUERY. Se non viene specificato alcun parametro, viene assunta 
l’unità di emissione specificata al momento dell'emissione della QUERY. Se non 
è specificata una unità di emissione nella QUERY, o non si è specificato un nome 
QUERY, viene assunto DISPLAY. 


DISPLAY specifica che il prospetto o l'emissione prodotta dalla query deve essere 
inviata all'unità video che ha lanciato la procedura. 


PRINTER specifica che il prospetto o l'emissione prodotta dalla query devono esse- 
re stampate. 


DISK specifica che l'emissione prodotta dalla query deve essere scritta su disco. 


ID STAMPATRICE specifica ("ID della stampatrice su cui deve essere stampato il 
prospetto. Se non viene specificato alcun parametro, viene assunto l'ID della stam- 
patrice specificata alla definizione della QUERY. Se non venne specificata una stam- 
patrice nella query, 0 non si è specificato un nome query, viene assunta la stampatrice 
di sessione. 


LARGHEZZA MODULO specifica la larghezza dei moduli su cui stampare il prospetto. 
Si può indicare un numero compreso tra 60 a 198. Se non viene specificato alcun 
parametro vigne assunta la larghezza specificata alle definizioni della query. Se non 
viene specificata alcuna larghezza nella query 0 non si è specificato un nome query, 
viene assunto 132. 


SPAZIATURE LINEE specifica il numero di linee bianche da lasciare tra le linee del pro- 
spetto. Si può indicare un numero da 1 a 3. 


®. 1 indica spazio singolo (nessuna linea bianca) 
® 2 indica spazio doppio (1 linea bianca) 
e 3 indica spazio tripio (2 linee bianche} 


Se non è specificato alcun parametro, viene assunto quello specificato al momento 
della definizione della QUERY. Se non venne specificato alcun parametro o non si 
è specificato un nome QUERY, viene assunto 1. 


COPIE specifica il numero di copie da stampare. Si può indicare un numero compreso 
tra 1 e 255. Se non viene indicato alcun parametro, viene assunto il numero indica- 
to alla definizione della query. Se non viene specificato alcun numero o non è speci- 
ficato un numero query viene assunto 1. 


NUMERO MODULI specifica il numero di un modulo particolare su cui si deve stampare 
il prospetto. Può essere un numero di 4 cifre. Quando il modulo è pronto per la 
stampa, un messaggio chiede se quel particolare modulo è montato sulla stampa- 
trice. L'operatore può così fare una verifica ed eventualmente cambiare modulo 
se necessario. 


Il numero moduli non può contenere i seguenti caratteri: virgole (,), apici (‘’), spazi 
in bianco, punti interrogativi (?), barrette (/), segni di maggiore (>), segni di uguale 
{=), e trattini (—). Se non è specificato alcun parametro, viene assunto quello spe- 
cificato nella QUERY. Se non viene specificato alcun parametro nella QUERY e non 
è indicato un nome QUERY, non viene assunto nessun numero. 


NOME FILE EMISSIONE specifica il file su disco che deve contenere l'emissione 
QUERY. Se non viene specificato alcun parametro, viene assunto il file specificato 
nella QUERY. Se non viene specificato alcun file nella QUERY e l'emissione QUERY 
viene inviata su disco, viene assunto il nome file # ORYOUT. Se non si specifica 
una opzione nella query, nessun nome file viene assunto. 


NEW o REPLACE specifica se il prospetto deve essere scritto su un file disco nuovo 
o se deve rimpiazzare il contenuto di un file su disco già esistente. Se non vie- 
ne specificato alcun parametro, viene assunta l'opzione NEW o REPLACE spe- 
cificata nella QUERY. Se non viene specificata alcuna opzione nella QUERY, 
o non è specificato un nome QUERY, viene assunto NEW. 


NEW specifica che il prospetto deve essere scritto su un file disco nuovo. 


REPLACE specifica che il prospetto deve rimpiazzare il contenuto di un file su disco 
già esistente sul sistema. 


NOPRINT o PRINT specifica se la definizione query deve essere stampata quando 
viene eseguita. Se non è specificato alcun parametro, viene assunta l'opzione 
NOPRINT o PRINT specificata nella query. Se non si specifica una opzione nel- 
la query o non è specificato un nome QUERY, viene assunto NOPRINT. 
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NOPRINT specifica che la definizione query non deve essere stampata quando vie- 
ne eseguita la query. 


PRINT specifica che la definizione deve essere stampata quando viene eseguita la 
query. Se nel quarto parametro c'è DISPLAY, PRINT non può essere specificato. 


NORECSEL o RECSEL specifica se l'interrogazione deve essere eseguita con la pro- 
va scelta tempo di esecuzione. Se non viene specificato nessun parametro, viene 
assunto NORECSEL. 


NORECSEL specifica che l'interrogazione deve essere eseguita senza la prova scel- 
ta tempo di esecuzione. 


RECSEL specifica che le prove scelte record devono essere modificate soltanto per 
questa esecuzione. Viene visualizzato uno schermo su cui è possibile modifi- 
care le prove scelta record definite nella interrogazione o specificare le prove 
scelta record se l'interrogazione non era stata specificata. 


DETAIL o SUMMARYspecifica il tipo di emissione prodotta dalla interrogazione. Se 
non è specificato alcun parametro, l'opzione DETAIL o SUMMARY specificata 
nell’interrogazione, viene assunta. Se non viene specificata nessuna opzione 
nella interrogazione o non è specificato un nome di interrogazione viene as- 
sunto DETAIL. 


DETAIL specifica che l'emissione prodotta dall'interrogazione deve essere un pro- 
spetto contenente record di dettaglio e record di totali se presenti. 


SUMMARY specifica che l'emissione prodotta dall’interrogazione deve essere un 
prospetto contenente soltanto record di totali. Se nel quarto parametro c'è DISK, 
SUMMARY non può essere specificato. 


PROCEDURA OQORYSAVE 


QRYSAVE 


La procedura QORYSAVE copia il supporto QUERY/36 su minidisco. Il supporto QUERY 
viene copiato dalle librerie #ORYLIB e # LIBRARY. Si può utilizzare la procedura ORY- 
LOAD per caricare il supporto QUERY/36 dai minidisco di riserva. Il minidisco che con- 
tiene la copia deve avere l'ID di volume PPQRY. 


La procedura QRYSAVE non ha parametri. 





PROCEDURA READINFO 


La procedura READINFO visualizza un documento nella sua forma definitiva. Il docu- 
mento può essere fornito con un prodotto programma IBM o creato utilizzando il DW/36. 


Nota: 
Il programma di utilità definizione dati interattivi, che è fornito con l'informazione in li- 


nea che la procedura READINFO può visualizzare, fa parte del prodotto programma di 
supporto del Sistema; non è un prodotto programma. 


READINFO nome documento,nome carvella,| testo di susitio| 


NOME DOCUMENTO specifica il documento che si vuole visualizzare. | documenti 
forniti dai prodotti programma IBM sono: 


e #IDDOC [per il programma di utilità definizione interattiva dati) 
e #WPDOC [per il DW/36) 

° #ORYDOC (per il QUERY/36) 

* #OFCDOC [peril PS/36). 


NOME CARTELLA specifica la cartella che contiene i documenti da visualizzare. Le 
cartelie che contengono documenti forniti dai prodotti programma IBM sono: 


. 41DDFLDR (per il programma di utilità definizione interattiva dati) 
®  #WPFLDR (per il DW/36) 

e #ORFLDR {per il QUERY/36) 

e #OFCFLDR (per il PS/36) 


TESTO DI AUSILIO specifica il punto nel documento che si vuole sia aperto. Se non 
è specificato alcun parametro, il documento è aperto alla prima pagina. 
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PROCEDURA REBLD 


La procedura REBLD è supportata soltanto per compatibilità con il Sistema/34 
della IBM. Vedere la Procedura COPYDATA per informazioni sulla copia di file 
su disco. 


PROCEDURA RELOAD 


La procedura RELOAD del Sistema/34 della IBM non è supportata. Vedere la Procedura 
RESTLIBR per informazioni sul ripristino (ricaricamento) della libreria di sistema (Il Siste- 
ma/36 non permette di specificare dati esadecimali in una procedura, pertanto il nono 
parametro della procedura REBLD non può contenere dati esadecimali) Vedere la Proce- 
dura SAVELIBR per informazioni sul salvataggio della libreria di sistema. 


REMOVE 


PROCEDURA REMOVE 


La procedura REMOVE rimuove da una libreria uno o più membri specificati di libreria. | 
membri di libreria forniti dalla IBM, non possono essere rimossi usando questa procedu- 
ra. Per rimuovere membri di libreria forniti dalla IBM vedere l’appendice A. 


Lo spazio che era occupato dai membri rimossi può essere usato di nuovo soltan- 
to se si verifica una delle seguenti condizioni: 


e il programma che tenta di usare lo spazio è il solo programma che usa la li- 
breria e nella libreria nessun membro segue fisicamente i membri rimossi. 


e Viene eseguita la procedura CONDENSE per comprimere la libreria. Vedere 
la Procedura CONDENSE, 


Per rimuovere il file o intere librerie dal disco o dai minidisco, vedere la Procedu- 
ra DELETE. La procedura REMOVE esegue il programma di utilità $SMAINT. 


nome membro ‘{.| SOURCE |,|nome libreria 
nome membro ,ALL |(S) libreria corrente 
PROC 

(P) 


ALL 


LOAD 
(0) 
SUBR 


(R) 
LIBRARY 


nome membro specifica il membro di libreria da rimuovere. 


nome membro,ALL specifica i caratteri di inizio dei nomi di uno o più membri 
di libreria da rimuovere. E’ possibile usare fino a 7 caratteri. 


ALL specifica che devono essere rimossi tutti i membri di libreria. Quando ven- 


gono specificati sia ALL che LIBRARY, nessun altro operatore può usare la 
libreria; se la libreria è quella di sistema (#LIBRARY), non possono essere in 
esecuzione altri lavori, 


SOURCE o S specifica che devono essere rimossi soltanto i membri origine di li- 
breria. Se non viene specificato alcun parametro, si presume SOURCE. 


PROC o P specifica che devono essere rimossi soltanto i membri di procedura di 
libreria. 


LOAD o O specifica che devono essere rimossi soltanto i membri oggetto di li- 
breria. 


SUBR o R specifica che devono essere rimossi soltanto i membri di sottoroutine 
di libreria. 


LIBRARY specifica che devono essere rimossi tutti ì tipi di membri di libreria 
(SOURCE, PROC, LOAD e SUBR). 


nome libreria specifica la libreria contenente i membri da rimuovere. Se non vie- 
ne specificato alcun nome di libreria, si presume la libreria corrente. 
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Esempio 1 


Rimuovere il membro di procedura denominato PAYROLL dalla libreria denomi- 
nata MYLIB. 


| REMOVE PAYROLL,PROC,MYLIB 


Esempio 2 
Rimuovere tutti i membri di libreria di sistemi denominati SAM. 


REMOVE SAM,LIBRARY, #LIBRARY 


Esempio 3 


Rimuovere tutti i membri di libreria che iniziano con i caratteri PAY dalla libre- 
ria denominata YOURLIB. 


REMOVE PAY,ALL,LIBRARY,YOURLIB 


Esempio 4 


Rimuovere un membro origine denominato THIS, un membro di procedura de- 
nominato THAT e tutti i membri origine che iniziano con THEM dalla libreria 
MYLIB (che è la libreria corrente). 


REMOVE THIS 
REMOVE THAT,P 
REMOVE THEM,ALL 


RENAME 


PROCEDURA RENAME 


La procedura RENAME cambia il nome di un file, di una libreria, o di una cartella. Un 
file, una libreria, o una cartella possono essere ridenominati soltanto se non corren- 
temente in uso. La procedura RENAME può essere usata per ridenominare file su 
un sistema remoto specificando l'identificazione del file locale come se fosse pre- 
sente nell’indirizzario risorsa di rete del sistema. Con l'utilizzo della procedura RE- 
NAME per ridenominare un file remoto, l’identificazione del nuovo file deve essere 
definita nell'indirizzario così come l’identificazione del vecchio file. La libreria di si- 
stema { LIBRARY) e i file di sistema (ad esempio il file storico), non possono essere 
ridenominati. 


La procedura RENAME esegue il programma di utilità $RENAME. 


nome corrente,nome nuovo,| mnggaa 
ggmmaa 
aammgg 





nome corrente specifica il nome corrente del file, della libreria, o della cartella. 


nome nuovo specifica il nuovo nome del file, delia libreria, o della cartella. Il nome 
nuovo non può essere più lungo di 8 caratteri e deve iniziare con un carattere alfa- 
betico {da A a Z, #, $,0@).] rimanenti caratteri possono essere alfabetici, nume- 
rici e speciali. Non si possono utilizzare i seguenti caratteri perchè essi hanno 
significati particolari nelle procedure: virgole (,), apici (’’), spazi in bianco, punti in- 
terrogativi (?), barrette (/), segni di maggiore (>), segni più (+), segni di uguale 
(=), e trattini (—). 


Il nuovo nome non può essere uguale ad un nome di file, libreria o cartella già 
esistente, a meno che non abbia una differente data di creazione. Comunque 
non usare ALL come nome file; ALL, DIR, DISK, F1, #LIBRARY, PRINT, TAPE 
o READER come nome libreria; ALL o #LIBRARY come nome cartella. 


mmggaa, ggmmaa o aammgg specifica la data di creazione del file (le librerie non 
hanno una data). La data, se specificata, deve essere nel formato della data 
di sessione. Usare il comando STATUS SESSION per determinare il formato 
della data di sessione. Se la data di creazione non è specificata ed esiste più 
di un file con il nome corrente, viene ridenominato !ultifno file creato. La 
data di creazione non viene modificata dalla procedura RENAME. 

Esempio 1 
Modifica del nome di un file esistente da OLDPAY a NEWPAY. 


RENAME OLDPAY,NEWPAY 


Esempio 2 


Modifica del nome di un file esistente da OLDPAY a NEWPAY, modifica di 
THIS in THAT e modifica di MYLIB in YOURLIB. 


RENAME OLDPAY,NEWPAY 
RENAME THIS,THAT 
RENAME MYLIB,YOURLIB 


375 


376 


PROCEDURA REQUESTX 


La procedura REQUESTX consente di richiedere o cancellare una funzione di- 
sponibile all'utente in una rete di dati pubblica X.21. In relazione alla rete, la 
registrazione per numerose azioni o servizi, può essere eseguita dall'ordine di ser- 
vizio all'atto dell'abbonamento o sulla rete stessa usando la procedura REQUESTX. 
La procedura REQUESTX è descritta nel manuale Using System/36 Communications. 


La procedura REQUESTX esegue il programma di utilità # GCFR. 


AES 


x 


| Per avere le richieste di sistema per le specifiche: 


REQUESTX 


Per far sì che il sistema elabori ie specifiche contenute in un membro origine di 
libreria: 









REQUESTX nome membro origine, |nome libreria , | NOENTRY 
libreria corrente| |ENTRY 





nome membro origine specifica il membro origine di libreria che contiene le specifi- 
che di cancellazione e di registrazione. Se il nome membro non è specificato, 
la procedura REQUESTX ne richiederà la specifica. 


nome libreria specifica la libreria che contiene il membro origine. Se non viene 
specificato alcun parametro, si presume la libreria corrente. 


NOENTRY specifica che il SEU non deve essere richiamato e che devono essere 
trasmesse ie specifiche del membro origine indicato. 


ENTRY specifica che il SEU deve essere richiamato per creare o modificare il 


membro origine prima che le specifiche vengano trasmesse dalla procedura 
REQUESTX. 
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Esempio 1 
Avviare la procedura REQUESTX che sollecita quindi le richieste. 


REQUESTX 


Esempio 2 


.. . Avviare.-la procedura REQUESTX che quindi-elaborerà il membro origine di li- 
breria REQ dalla libreria corrente (denominata MYLIB). 


REQUESTX REQ 
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PROCEDURA RESPONSE 


La procedura RESPONSE aggiorna ì valori di risposta automatica e i livelli di 
gravità per i messaggi in un membro oggetto di messaggi. Questi valori possono 
essere assegnati sia ai messaggi forniti dalia IBM che ai messaggi scritti dall'utente. 
Molti messaggi forniti dalla IBM prevedono livelli di gravità e molti prevedono ri- 
sposte automatiche. Questi valori sono indicati con il messaggio nei seguenti 
manuali di messaggi: 


e  Guidaai messaggi del sistema 

e Guida ai messaggi RPG Il 

e Guida ai messaggi dei programmi di utilità 

e COBOL Messages 

e Assembler Messages 

e BASIC Messages 

e MSAIJE Messages 

e 3270 Messages 

Il livello di gravità è usato per stabilire se il sistema deve rispondere automatica- 
mente ad un messaggio visualizzato. La procedura NOHALT o la specifica OCL de- 
vono essere eseguite se la procedura RESPONSE è attiva. Il livello di gravità del si- 
stema, della sessione o del lavoro è impostato dalla procedura o dalla specifica OCL 


NOHALT; vedere la Procedura NOHALT e la Specifica OCL NOHALT per ulteriori 
informazioni sull’impostazione del livello di gravità. 


L'immissione alla procedura RESPONSE è un membro origine di risposta automa- 
tica che contiene per ciascun messaggio a cui rispondere: il codice alfabetico, il 
codice di identificazione messaggio (MIC), la risposta e il livello di gravità, li 
membro origine può essere creato usando il SEU o il programma di utilità 
$MAINT. 


Le modifiche effettuate dalla procedura RESPONSE rimangono in effetto fino a che non 
vengono modificate da un’altra procedura RESPONSE o fino a che non viene installato 
un nuovo rilascio. Vedere la procedura NOHALT per informazioni su quanto a lungo la 
procedura NOHALT rimane in effetto. Vedere Considerazioni di programmazione per la 
risposta automatica per altri dettagli. 


Il membro origine di risposta. automatica contiene tre tipi di specifiche. Vedere 
Specifiche origine risposta automatica per informazioni sul formato di queste spe- 
cifiche. 


e La specifica di controlio risposta automatica 
e Unao più specifiche informative di risposta automatica 


e Unao più specifiche di commenti (facoltativi). 
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RESPONSE nome membro origine, nome libreria 





La procedura RESPONSE esegue il programma di utilità $ARSP. 


nome membro origine specifica il membro origine che contiene le specifiche di 


commento. 


nome libreria specifica la libreria che contiene il membro origine. Se non è speci- 
ficato un nome di libreria, si presume la libreria corrente. 


Esempio 


Per applicare le risposte automatiche contenute nel membro origine di libreria 
denominato AUTORESP (che è memorizzato in una libreria denominata MYLIB): 


RESPONSE AUTORESP ,MYLIB 
Specifiche origine di risposta automatica 


La specifica di controllo risposta automatica 


tomatica e specifiche di comando. 


La sintassi della specifica di controllo di risposta automatica è: 


codice alfabetico, [pone membro oggetto| 3 [nome Libreria][conmenti]. 
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Z3N 
libreria corrente 
controllo di risposta automatica, le specifiche informative e le specifiche di 
La specifica di controllo risposta automatica, indica il codice alfabetico per la speci- «i 
fica informativa di risposta automatica che segue. | codici alfabetici sono i tre o 
quattro caratteri che sono visualizzati prima del numero MIC. Per esempio se viene 
visualizzato il messaggio SYS-1395, SYS è il codice alfabetico e 1395 è il numero 
MIC. Questa specifica deve venire prima delle specifiche informative di risposta au- 
tomatica. Un membro origine può contenere più di una specifica di controllo rispo- 
sta automatica e ciascuna può avere la propria specifica informativa di risposta au- 
codice alfabetico specifica il codice alfabetico dei messaggi ai quali vengono attri- 
buiti i valori di risposta automatica. Il codice alfabetico deve essere uno dei 
seguenti: 
I ASM DSU IWS SDA USER 
BAS EMU KBD SEU WSU 
| BGU EP NRD SORT 
CBL ESU OFC SRTX 
CGU ET ORY SYS 
DFU FORT RJE TTM 
j DHCF IDDU RPG TXT Lala 


Occorre ora raggruppare i messaggi con gli stessi codici alfabetici nel membro ori- 


gine. Ciò consente di aggiornare più facilmente il membro origine. 


nome membro aggetto specifica il membro oggetto di messaggi di cui devono es- 
sere aggiornati Î valori di risposta automatica. Se il codice alfabetico è USER, 
deve essere specificato il nome del membro. Se il codice alfabetico non è 
USER, il parametro del nome del membro viene ignorato e la funzione di 
utilità $ARSP determina il nome del membro. 


nome libreria specifica la libreria che contiene il membro oggetto di messaggi. Se 
il codice alfabetico è USER, il nome della libreria può essere indicato o me- 
no; se non è indicato, si presume la libreria di sistema (#LIBRARY). Se il 
codice alfabetico non è USER, il parametro dei nome della libreria viene 
ignorato ed il programma di utilità $ARSP determina il nome della libreria. 


commenti specifica ogni informazione che può essere utile per identificare il mes- 
saggio o la risposta desiderata. Questa informazione non è usata dal sistema. 
Devono essere disposti uno o più spazi in bianco davanti al commento. 


Specifica informativa di risposta automatica 


La specifica informativa di risposta automatica, indica il codice di identificazione 
dei messaggio (MIC) del messaggio da aggiornare e i valori di livello di gravità e di 
risposta automatica per quel messaggio. 


Se è indicata una specifica informativa di risposta automatica per un messaggio 
che non si trova nel membro di messaggio specificato, viene visualizzato un erro- 
re. Il formato della specifica informativa di risposta automatica è: 


risposta,livello di gravità [conmenti | 


mie specifica il codice di identificazione messaggio del messaggio (MIC). IH MIC 
deve essere un numero a quattro cifre da 0000 a 9999 e deve essere disposto 
nelle posizioni da 1 a 4 delle specifiche del testo di messaggio. 1 MIC devono 
essere in ordine numerico ascendente. 


risposta specifica il valore di risposta automatica per il messaggio, | valori sono 
O, 1, 23, Do N, Se viene specificato N. viene usato il valore di risposta au- 
tomatica fornito dalia IBM per il MIC specificato. La risposta automatica 
deve essere inserita nella posizione 6 della specifica. Vedere l'appropriato ma- 
nuale dei messaggi per una descrizione delle risposte in relazione al valore 
che si vuole aggiornare, 


Quando un lavoro viene cancellato automaticamente da un'opzione 3, viene 
visualizzato un messaggio indicante che il lavoro è stato canceliato dal si- 
stema. 
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livello di gravità specifica il livello di gravità del messaggio. | valori ammessi sono 


1, 


2,3, 4 e 5. Il valore deve essere inserito nella posizione 8 della specifica. 


E’ possibile specificare che si deve dare la risposta automatica soltanto ai 
messaggi con un livello di gravità specifico; vedere la Procedura NOHALT e 
la Specifica OCL NOHALT per i modi in cui indicare questo livello di gravi- 
tà per il sistema, sessione o lavoro. 


Gli orientamenti di livello di gravità usati per i messaggi forniti dalla IBM 
sono i seguenti: 


1 


2 


Messaggi informativi (solo opzione 0). 


Messaggi con un'opzione; i messaggi con due opzioni dove un'opzione 
è un'opzione di ripetizione. 


Messaggi di errore di programma; questi solitamente hanno più di un'op- 
zione. 


Messaggi per errori molti seri ad esempio errori hardware o errori di im- 
missione/emissione permanenti. 


Per questo messaggio non viene definito alcun valore di risposta auto- 
matica, î 


commenti specifica qualsiasi informazione che può essere utile per identificare il 
messaggio o la risposta desiderata. Questa informazione non è usata dal siste- 
ma. Davanti al commento devono essere inseriti uno o più spazi in bianco. 


Specifica di commento 


* commenti 


Specifica qualsiasi informazione che può essere utile per identificare il messaggio 
‘ 0 la risposta desiderata. Questa informazione non è usata dal sistema. Il formato 
della specifica di commento è il seguente: 


L'asterisco (*) deve essere il primo carattere nella specifica. Le specifiche di com- 
mento possono essere disposte ovunque nell’ambito delle altre specifiche. 


Pam 


Considerazioni di programmazione della risposta automatica 
Non si deve specificare il valore di risposta automatica a messaggi che: 


e indicano errori permanenti di immissione/emissione 
e Indicano che è stata eseguita una copia del contenuto della memoria 


e Chiedono che un operatore faccia qualche cosa prima che si debba risponde- 
re al messaggio 


e Indicano un'opzione di ripetizione 


e Sono messaggi di errore della funzione di risposta automatica (la procedura 
RESPONSE). 


Quando si scelgono i valori, assicurarsi che non si traducano in perdite di dati o 
nel riempimento del file storico, cronologico con messaggi ripetitivi. 


Si consideri quanto segue quando si assegnano valori di messaggi: 


e Ai messaggi si deve rispondere automaticamente soltanto se si verificano le 
seguenti condizioni: 


— Il messaggio richiede una risposta. 
— II valore di risposta automatica ha un valore che il messaggio ammette. 


e Sia il messaggio che la risposta sono registrati nel file storico, cronologico. 


e E’ possibile mantenere due membri origine. Uno di questi conterrebbe i valo- 
ri di risposta automatici; l’altro conterrebbe il valore di risposta N (nella co- 
lonna 6 di tutte le specifiche informative di risposta automatica). 


Mantenendo due membri origine, è possibile usarne uno per i valori di rispo- 
sta automatica e l’altro per i valori di risposta automatica forniti dalla IBM. 
Per ripristinare i valori di risposta automatica forniti dalla IBM, occorre ese- 
guire la procedura RESPONSE usando il membro origine che contiene la N 
nella colonna 6. 
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Esempio di membro origine di risposta automatica 


Si supponga che un membro origine contenga le seguenti specifiche, Notare come 
le stesse sono raggruppate dai codici alfabetici e i MIC sono listati in ordine nu- 
merico. 


* Messaggi di risposta automatica visualizzati dal SSP 

SYS 

1051 3,3 Parametro LPI non valido.. deve essere 1,6 oppure 8 

1063 3,3 Parametro LIBRARY non valido 

1272 3,3 Specifica FILE non può avere indicato sia RETAIN-J sia JOB-YES 
* 


* Messaggi di risposta automatica visualizzati dall'RPG 
RPG i 





9011 0,3 Tentata estrazione di radice quadrata da un numero negativo 
9013 0,3 Tentativo divisione per zero 

9016 0,3 Nessun dato trovato per caricamento tabelle 

9037 0,3 Tentata aggiunta di chiavi non in sequenza 

* 


* Messaggi di risposta automatica visualizzati dall'utente 
* Il membro oggetto dei messaggi si chiama MESSAGES, 

* ed è contenuto nella libreria MYLIB 

USER ,MESSAGES,MYLIB 

0001 2,3 Errore nel codice cliente 

0012 0,2 Errore nel codice articolo 


E’ possibile usare il seguente membro origine per ritornare alle risposte fornite 
dalla IBM: 


* Messaggi di risposta automatica visualizzati dal SSP 

SYS 

1051 N Parametro LPI non valido..deve essere },6 oppure 8 

1063 N Parametro LIBRARY non valido 

1272 N Specifica FILE non può avere indicato sia RETAIN-J sia JOB-YES 
* 


* Messaggi di risposta automatica visualizzati dall'RPG 

RPG 

9011 N Tentata estrazione di radice quadrata da un numero negativo 
9013 N Tentativo divisione per zero : 

9016 N Nessun dato trovato per caricamento tabelle 

9037 N Tentata aggiunta di chiavi non in sequenza 





PROCEDURA RESTFLDR 


. La procedura RESTFLDR ripristina una cartella che era stata copiata su un minidi- 
| sco, nastro o nastro a cassetta, con la procedura SAVEFLDR. Si può specificare 
una locazione preferita per la cartella. 


La procedura RESTFLDR esegue il programma di utilità $TMSERV. 


NOAUT 


gemmaa 
aammgg 


RESTFLDR nome cartella,|mmggaa |, iero | 
(e) 


numero blocco 


REWIND 
LEAVE 
UNLOAD 





nome cartelia specifica la cartella da ripristinare 


mmggaa, ggmmaa o aammgg specifica la data di creazione delia cartella da ripristinare; 
deve essere nello stesso formato di quello su minidisco o nastro. 


A1,A2, A3 o AA indica la preferenza del disco; cioè l’unità disco che viene esaminata 
per prima nella ricerca di spazio disponibile. Se su quell’unità non è disponibile spa- 
zio a sufficienza, vengono esaminate le altre unità (se esistono) e la cartella viene 
inserita sull'unità disco meno usata. Se non è specificata alcuna locazione ed il si- 
stema dispone di più di un’unità disco, la cartella viene inserita sull'unità disco me- 
no usata. 

A1 specifica che la cartella sarà inserita sul primo disco, se è disponibile spazio. 
A2 specifica che la cartella sarà inserita sui secondo disco, se è disponibile spazio. 
A3 specifica che la cartella sarà inserita sul terzo disco, se è disponibile spazio. 
AA specifica che ila cartella sarà inserita sul quarto disco, se è disponibile spazio. 
numero blocco specifica la locazione del primo blocco della cartella. È possibile 


specificare fino a 6 cifre. È possibile usare la procedura CATALOG per determinare 
dove sono disponibili blocchi di spazio su disco. 


384.1 


384.2 


{1 specifica che la cartella deve essere ripristinata da minidisco. Se non viene 
assegnato alcun parametro, viene assunto 11. 


T1, T2 o TC specifica che la cartella deve essere ripristinata da nastro. T1 indica 
che la bobina è montata sull'unità nastro 1. T2 sull'unità nastro 2. TC indica 
che il nastro è un nastro a cassetta. 


S1, S2 o $3 specifica l'alimentatore a minidischi contenente il primo minidisco da 
usare. Se non è specificata alcuna posizione di minidisco, si presume S1. Que- 
sto parametro non è consentito se è specificato T1, T2 o TC. 


M1.nn o M2.nn specifica la locazione del caricatore che contiene il primo minidisco 
da usare. M1 indica il primo caricatore e M2 indica il secondo, nn è un valore 
decimale da 01 a 10 che identifica la locazione del minidisco nel caricatore. 
Specificare M1 equivale a specificare M1.01. Specificare M2 equivale a speci- 
ficare M2.01. Questo parametro non è consentito se è specificato T1, T2 o 


TC. 


AUTO specifica quanto segue: 


Se viene specificato $1, S2 o $3, possono essere usati tutti e tre i singoli 
alimentatori (S1, $2 e $3). L'elaborazione inizia con il minidisco nell’alimenta- 
tore specificato e continua fino al minidisco nell’alimentatore S3. Se occorro- 
no altri minidischi, viene visualizzato un messaggio e l'operatore deve inserire 
i successivi minidischi. L'elaborazione riprende col minidisco nell’alimentatore 
S1. 


Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli ali- 
mentatori di caricatore (M1 e M2). L'elaborazione inizia con il minidisco nella 
locazione specificata e continua fino al minidisco nella locazione M2.10. Se 
occorrono altri minidischi, viene visualizzato un messaggio e l'operatore deve 
inserire i successivi caricatori. L'elaborazione riprende alla locazione M1.01. 


Se viene specificato T1 o T2, quando la bobina di nastro sull'unità nastro origi- 
nale è terminata, il sistema passa all'altra unità nastro, se disponibile, per con- 
tinuare l'elaborazione (da T1 a T2 o da T2 a T1). Se l’altra unità non è disponibile, 
viene usata l'unità originale. Una richiesta verificherà che la bobina montata 
sia quella giusta. 


Se è specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


Se non è specificato alcun parametro, si assume AUTO. 


NOAUTO specifica quanto segue: 


* Se viene specificato $1, $2 o S3, può essere usato soltanto l'alimentatore 
specificato. Se occorrono altri minidischi, viene visualizzato un messaggio e 
l'operatore deve inserire il successivo minidisco nell’alimentatore specificato. 


e Seviene specificato M1.nn o M2.nn, può essere usato soltanto il caricatore 
specificato. L'elaborazione inizia con il minidisco nella locazione specificata 
e continua fino all'ultimo minidisco nel caricatore. Se occorrono altri minidi- 
schi, viene visualizzato un messaggio e l'operatore deve inserire il successivo 
caricatore nell’alimentatore che viene usato. L'elaborazione riprende alla pri- 
ma locazione nel caricatore. 


e Sevienespecificato T1 o T2, per tutti i volumi di nastro verrà usata soltanto 
l’unità nastro specificata. 


e Seè specificato TC, ii parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


REWIND specifica che il nastro deve essere riavvolto dopo aver eseguita la proce- 
| dura RESTFLDR. Questo parametro è valido solo se si specifica T1, T2 o TC. 
Se non viene specificato alcun parametro, viene assunto REWIND. 


LEAVE specifica che il nastro deve essere lasciato dov'è dopo che è stata eseguita 
la procedura RESTFLDR. L'operazione successiva sul nastro inizia da questa 
] posizione. Questo parametro è valido solo se si specifica T1, T2 o TC. 
UNLOAD specifica che il nastro deve essere riavvolto e scaricato dopo che è stata 
eseguita la procedura RESTFLDR. Questo parametro non è valido se si specifi- 
ca 11. Se sono specificati UNLOAD e TC, il nastro verrà riavvolto dopo 
l'elaborazione. 


Esempio 1 


| Questo esempio mostra il ripristino della cartella denominata MYFLDR da minidisco. 


| RESTFLDR MYFLDR 


Esempio 2 


Questo esempio mostra il ripristino della cartella MYFLDR da nastro. Il nastro è sull’uni- 
tà T1. Dopo il ripristino, il nastro viene riavvolto e scaricato. 


RESTFLDR MYFLDR,,,T1, NOAUTO, UNLOAD 


384.3 








384.4 
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PROCEDURA RESTLIBR 


La procedura RESTLIBR ripristina una libreria copiata su minidisco, nastro, o nastro 
a cassetta dalla procedura SAVELIBR. È possibile modificare la dimensione della li- 
breria dell'utente e la dimensione dell'indirizzario di tale libreria o specificare un nuovo 
nome di libreria diverso da quello del minidisco, nastro o nastro a cassetta. Non è 
possibile modificare la dimensione della libreria di sistema (# LIBRARY) o quella del 
suo indirizzario usando la procedura RESTLIBR. Non è inoltre possibile specificare 
una locazione preferita sul disco per # LIBRARY. Per informazioni sulla modifica della 
dimensione di #LIBRARY o del suo indirizzario, vedere il manuale Modifica della 
configurazione del sistema. 


Per copiare da un file su disco, su minidisco o su nastro i singoli membri in una libreria, 
vedere la Procedura TOLIBR. (File copiati dalia procedura TOLIBR devono essere stati x 
creati dalla procedura FROMLIBR o dal programma di utilità $MAINT). Per ripristinare 

i file di dati, vedere la Procedura RESTORE. S 


La procedura RESTLIBR esegue il programma di utilità $SMAINT. 


RESTLIBR nome libreria, [ ampiezza libreria | ; [ampiezza indirizzario | 


Al , {Sl . {AUTO . {Il |, {REWIND |, {mmggaa |, [nome nuovo 
A2 S2 NOAUTO TI LEAVE ggmmaa libreria 
S3 . - T2 UNLOAD aammgg 
A4 Ml.nn 
numero blocco M2.nn 





nome libreria specifica la libreria che deve essere ripristinata. Deve essere specifi- 
cato un nome di libreria. Se la libreria di sistema viene ripristinata (FLI- 
BRARY), il livello di rilascio della copia salvata deve corrispondere alla copia 
sul sistema. 


Se ia libreria specificata esiste già, viene visualizzato un messaggio che con- 
sente di: ° 


e Cancellare la procedura RESTLIBR 
e Cancellare ia libreria dal disco e proseguire con la procedura RESTLIBR. 


ampiezza libreria specifica la nuova dimensione, in blocchi, della libreria. Un 
blocco contiene 2560 byte. La dimensione massima della libreria è di 15.000 
biocchi. Se non viene indicata una dimensione, viene usata la dimensione sal- 
vata con la libreria. 


ampiezza indirizzario specifica la nuova dimensione, in settori, dell'indirizzario 
della iibreria. La dimensione minima dell’indirizzario è di 2 settori; la dimen- 
sione massima è di 2500 settori. Un blocco di libreria contiene 10 settori. Se 
non è specificata una dimensione di indirizzario, viene usata la dimensione 
salvata con la libreria. 
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A1, A2, A3 o A4 indica la preferenza del disco; cioè l’unità disco che viene esaminata 
per prima nella ricerca di spazio disponibile. Se su queli"unità non è disponibile spa- 
zio a sufficienza, vengono esaminate le altre unità {se esistono) e la libreria viene 
inserita sull'unità disco meno usata. Se non è specificata alcuna locazione ed il si- 
stema dispone di più di un'unità disco, la libreria viene inserita sull'unità disco me- 
no usata. 


A1 specifica che la libreria sarà inserita sul primo disco, se è disponibile spazio. 
A2 specifica che la libreria sarà inserita sul secondo disco, se è disponibile spazio. 
A3 specifica che la libreria sarà inserita sul terzo disco, se è disponibile spazio. 
AA4 specifica che la libreria sarà inserita sul quarto disco, se è disponibile spazio. 


numero blocco specifica la locazione del primo blocco della libreria. È possibile 
specificare fino a 6 cifre. È possibile usare la procedura CATALOG per determinare 
dove sono disponibili blocchi di spazio su disco. 


S1, S2 o $3 specifica l'alimentatore a minidischi contenente il primo minidisco da elabo- 
rare. Se non viene specificato alcun parametro, si presume S1. Se viene specifica- 
to T1, T2 0 TC questo parametro non può essere specificato. 


M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidisco da 
elaborare. M1 indica il primo caricatore e M2 indica il secondo, nn è un numero 
da 01 a 10 che identifica la locazione del minidisco nel caricatore. Specificare M1 
equivale a specificare M1.01; specificare M2 equivale a specificare M2.01. Se vie- 
ne specificato T1, T2 o TC questo parametro non può essere specificato. 


AUTO specifica quanto segue: 


® Se viene specificato S1, S2 o S3, possono essere usati tutti e tre i singoli 
alimentatori (S1, S2 e S3). L'elaborazione inizia con il minidisco ne!l‘ali- 
mentatore specificato e continua fino al minidisco nell’alimentatore S3. 
Se occorrono altri minidischi, viene visualizzato un messaggio e l'opera- 
tore deve inserire i successivi minidischi. L'elaborazione riprende col mi- 

.  nidisco nell’alimentatore S1. 


e Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli 
alimentatori di caricatore (M1 e M2). L'elaborazione inizia con il minidi- 
sco nella locazione specificata e continua fino al minidisco nella locazio- 
ne M2.10. Se occorrono altri minidischi, viene visualizzato un messaggio 
e l'operatore deve inserire i successivi caricatori. L'elaborazione riprende 
alla locazione M1.01. 


* Sevienespecificato T1 o T2, quando la bobina di nastro sull'unità nastro origi- 
nale è terminata, il sistema passa all'altra unità nastro, se disponibile, per con- 
tinuare l'elaborazione (da T1 a T2 o da T2 a T1). Se l'altra unità non è disponibile. 
viene usata l’unità originale. Una richiesta verificherà che la bobina montata 
sia quella giusta. 


Se non è specificato alcun parametro, si assume AUTO. 


NOAUTO specifica quanto segue: 


e Se viene specificato 51, S2 o S$3, può essere usato solanto l'alimentatore 
specificato. Se occorrono altri minidischi, viene visualizzato un messaggio 
e l'operatore deve inserire il successivo minidisco nell’alimentatore speci- 


ficato. . 


e Se viene specificata M1.nn o M2.nn, può essere usato soltanto il carica- 
tore specificato. L'elaborazione inizia con il minidisco nella locazione 
specificata e continua fino all'ultimo minidisco nel caricatore. Se occor- 
rono altri minidischi, viene visualizzato un messaggio e l'operatore deve 
inserire if successivo caricatore neil’alimentatore che viene usato. L'’ela- 
borazione riprende alla prima locazione nei caricatore. 


e Se viene specificato T1 o T2, per tutti i volumi di nastro verrà usata sol- 
tanto l’unità nastro specificata. 


e  Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


11 specifica che la libreria deve essere ripristinata da minidisco. Se non viene speci- 
ficato alcun parametro, viene assunto |1. 


T1,T20TC specifica che la libreria sarà ripristinata da nastro. T1 indica che il na- 
stro è montato sull'unità 1. T2 indica che il nastro è montato sull'unità 2. TC 
indica che il nastro è un nastro a cassetta. 


REWIND specifica che il nastro deve essere riavvolto dopo aver eseguito la proce- 
dura RESTLIBR. Si presume REWIND se questo parametro non viene specifica- 
to. TC indica che il nastro è un nastro a cassetta. 


LEAVE specifica che il nastro deve essere lasciato dov'è dopo che è stata eseguita 
la procedura RESTLIBR. L'operazione successiva sul nastro inizia da questa po- 
sizione. TC indica che il nastro è un nastro a cassetta. 


UNLOAD specifica che il nastro deve essere riavvolto e scaricato dopo che è stata 
eseguita la procedura RESTLIBR. TC indica che il nastro è un nastro a casset- 
ta. Se sono specificati UNLOAD e TC, il nastro verrà riavvolto dopo 
l'elaborazione. 


mmggaa, ggmmaa o aammgg indica la data di creazione del file da ripristinare. La 
data deve essere indicata nello stesso formato della data di creazione del file 
su minidisco a del file su nastro. 


nome nuovo libreria specifica il nome della libreria da ripristinare se si vuole modifi- 
care il nome della libreria indicato sul minidisco, nastro o nastro a cassetta. 
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Esempio 1 
Questo esempio mostra la libreria di sistema che viene ripristinata. 


RESTLIBR #LIBRARY 


Esempio 2 


Questo esempio mostra una libreria denominata PAYLIB che viene ripristinata, 
La dimensione della libreria e la dimensione dell’indirizzario non sono modificati. 


RESTLIBR -PAYLIB 


Esempio 3 


Questo esempio mostra una libreria denominata PAYLIB che viene ripristinata. 
La dimensione della libreria viene modificata in 300 blocchi. La dimensione del- 
l’indirizzario viene modificata in 30 settori. 


RESTLIBR PAYLIB,300,30 


Esempio 4 


Questo esempio mostra una libreria denominata PAYLIB che viene ripristinata, 
preferibilmente sul disco A2. La dimensione della libreria e la dimensione dell’in- 
dirizzario non vengono modificate, La libreria è memorizzata su una bobina di 
nastro che viene montata sull'unità nastro 1. Dopo aver ripristinato la libreria, il 
nastro viene riavvolto e scaricato. 


RESTLIBR PAYLIB,,,A2,,,,T1,UNLOAD 
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PROCEDURA RESTNRD 


#NRD . FLE 


La procedura RESTNRD ripristina una versione di un indirizzario risorse rete da mini- 


disco, nastro o nastro a cassetta su disco. La versione da ripristinare deve essere 


stata salvata (come un file) dalla procedura SAVENRD. 

Il sistema assegna il nome #NRD.FLE al file di indirizzario. Se questo già esiste, si può 
utilizzare la procedura DELNRD per rimuoverlo in modo da poter ripristinare un’altra ver- 
sione dell’indirizzario sul sistema. 


Per maggiori informazioni vedere il manuale ‘DISTRIBUTED DATA MANAGEMENT 
GUIDE". 


La procedura RESTNRD esegue i programmi di utilità $COPY e $SINCT. 


#}I3|.{S1 +{ AUTO ,|REWIND|,]|A1 


nome file] |TT| |S2 NOAUTO] |LEAVE A2 


T2 S3 UNLOAD A3 
M].nn A4 
M2.nn numero blocco 





#NRD.FLE specifica che il file denominato #NRD.FLE deve essere ripristinato su disco. 
Se non viene specificato alcun parametro, viene assunto #NRD.FLE. 


nome file specifica il nome del file (su minidisco o nastro) che deve essere ripristinato 
su disco. Questo è il nome con cui l'indirizzario viene salvato. Se esiste più di un 
file con il nome specificato, il sistema ripristina il primo che trova su minidisco o 
nastro con quel nome. 


11 specifica che il file deve essere ripristinato da minidisco. Se non viene specificato 
alcun parametro, viene assunto 11. 


T1,T2 0 TC specifica che il file deve essere ripristinato da nastro. T1 indica che 
la bobina è montata sull'unità nastro 1. T2 sull'unità nastro 2. TC indica che 
il nastro è un nastro a cassetta. 


388.1 


388.2 


S1, S2 o 83 specifica l'alimentatore a minidischi contenente il primo minidisco da ela- 
borare. Se non viene specificato alcun parametro, si presume 51. Se viene specifi 
cato T1, T2 o TC, questo parametro non può essere specificato. 


M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidisco da 
elaborare. M1 indica il primo caricatore e M2 indica il secondo, nn è un numero 
da 01 a 10 che identifica la locazione del minidisco nel caricatore. Specificare M1 
equivale a specificare M1.01; specificare M2 equivale a specificare M2.01. Se vie- 
ne specificato T1, T2 o TC, questo parametro non può essere specificato. 


AUTO specifica quanto segue: 


Se viene specificato S1, S2 o S3, possono essere usati tutti e tre i singoli 
alimentatori (S1, S2 e S3). L'elaborazione inizia con il minidisco nell’ali- 
mentatore specificato e continua fino al minidisco nell’alimentatore S3. 
Se occorrono altri minidischi, viene visualizzato un messaggio e l’opera- 
tore deve inserire i successivi minidischi. L'elaborazione riprende col mi- 
nidisco neil’alimentatore S1. 


Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli 
alimentatori di caricatore (M1 e M2). L'elaborazione inizia con il minidi- 
sco nella locazione specificata e continua fino al minidisco nella locazio- 
ne M2.10. Se occorrono altri minidischi, viene visualizzato un messaggio 
e l'operatore deve inserire i successivi caricatori. L'elaborazione riprende 
alla locazione M1.01. 


Se viene specificato T1 o T2, quando la bobina di nastro sull'unità nastro origi- 
nale è terminata, il sistema passa all'altra unità nastro, se disponibile, per con- 
tinuare l'elaborazione {da T1 a T2 o da T2 a T1). Se l’altra unità non è disponibile, 
viene usata l’unità originale. Una richiesta verificherà che la bobina montata 
sia quella giusta. 


Se è specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


Se non è specificato alcun parametro, si assume AUTO. 


NOAUTO specifica quanto segue: 


Se viene specificato S1, S2 o S3, può essere usato solanto l'alimentatore 
specificato, Se occorrono altri minidischi, viene visualizzato un messaggio 
e l'operatore deve inserire il successivo minidisco nell’alimentatore speci- 
ficato. 


Se viene specificato M1.nn o M2.nn, può essere usato soltanto il carica- 
tore specificato. L'elaborazione inizia con il minidisco nella locazione 
specificata e continua fino all'ultimo minidisco nel caricatore. Se occor- 
rono altri minidischi, viene visualizzato un messaggio e l'operatore deve 
inserire il successivo caricatore nell’alimentatore che viene usato. L'ela- 
borazione riprende alla prima locazione nel caricatore. 


Se viene specificato T1 o T2, per tutti i volumi di nastro verrà usata sol- 
tanto l’unità nastro specificata. 


Se è specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


REWIND specifica che il nastro deve essere riavvolto dopo aver eseguito la procedura 
RESTNRD. Questo parametro è valido solo se si specifica T1, T2 o TC. Se non 
viene specificato alcun parametro, viene assunto REWIND. 


LEAVE specifica che il nastro deve essere lasciato dov'è dopo che è stata eseguita la 
procedura RESTNRD. L'operazione successiva parte da questa posizione. Questo 
parametro è valido solo se si specifica T1, T2 o TC. 


UNLOAD specifica che il nastro deve essere riavvalto e scaricato dopo che è stata ese- 


guita la procedura RESTNRD. Questo parametro non è valido se si specifica 11. 
Se sono specificati UNLOAD e TC, il nastro verrà riavvolto dopo l'elaborazione. 


A1, A2, A3 0 AA indica la preferenza del disco; cioè l'unità disco che viene esaminata 
per prima nella ricerca di spazio disponibile. Se su quell’unità non è disponibile spa- 
zio a sufficienza, vengono esaminate altre unità (se esistono) e il file viene inserito 
sull'unità disco meno usata. Se non è specifica alcuna locazione ed il sistema di- 
spone di più di un’unità disco, il file viene inserito sull'unità disco meno usata. 
A1 specifica che il file sarà inserito sul primo disco. Se è disponibile spazio. 
A2 specifica che il file sarà inserito sul secondo disco. Se è disponibile spazio. 
A3 specifica che il file sarà inserito sul terzo disco. Se è disponibile spazio. 

AA specifica che il file sarà inserito sul quarto disco. Se è disponibile spazio. 
numero blocco specifica la locazione del primo blocco del file. È possibile specifi- 
care fino a 6 cifre. E possibile usare la procedura CATALOG per determinare dove 
sono disponibili blocchi di spazio su disco. 
Esempio 1. 

Questo esempio ripristina il file denominato # NRD.FLE da un minidisco posto nell’ali- 

mentatore 2 su qualsiasi spazio su disco. (Il file deve essere stato salvato con la proce- 


dura SAVENRD). Quando il file viene ripristinato non deve essere presente sul sistema 
nessun altro indirizzario di risorsa rete. 


RESTNRD,, 52 


Esempio 2 
Questo esempio rispristina il file di riserva NRD.BKUP da nastro su disco. La bobina 
deve essere montata sull'unità 1 e deve essere lasciata li dove è, dopo che l’indirizzario 


è stato ripristinato. L'indirizzario deve essere messo sul secondo disco, se c'è spazio 
disponibile. 


RESTNRD NRD.BKUP,T1,,,LEAVE,A2 


388.3 


388.4 
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PROCEDURA RESTORE 


La procedura RESTORE ripristina su disco un file o un gruppo di file salvati su mini- 
disco, su nastro o nastro a cassetta. Il file su minidisco o su nastro deve essere 
stato creato da uno fra quanto segue: 


e La procedura SAVE 
» Il programma di utilità $COPY 


Quando deve essere ripristinato un solo file, è possibile modificare la dimensione 
di quel file specificando il parametro RECORDS o BLOCKS. E‘ inoltre possibile 
indicare la preferenza del disco o il numero di blocco dove deve avere inizio il 
file specificando il parametro LOCATION. 


La procedura RESTORE può essere usata per ripristinare file locali su minidisco indi- 
vidualmente su un sistema remoto. Vedere il manuale Distributed Data Management 
Guide. 


La procedura RESTORE esegue il programma di utilità $COPY. $ COPY non elabora 
una libreria, una cartella, i file di sistema quali un file di stampa differita o un file 
su minidisco, su nastro o nastro a cassetta, che non siano stati creati da $COPY. 


Per ripristinare una libreria, vedere la Procedura RESTLIBR. Per ripristinare una cartella, 
vedere la Procedura RESTFLDR. Per ripristinare un indirizzario di risorse rete, vedere 
la Procedura RESTNRD. Per copiare i file su minidisco in formato base di interscambio 
o in formato di interscambio | vedere la Procedura TRANSFER. Per copiare minidischi 
in formato speciale E (i minidischi creati dal 5260 Retail System), vedere la Procedura 
POST. Per copiare sul disco i file su nastro in formato di interscambio, vedere la Proce- 
dura TAPECOPY. 


Quando si stanno copiando di nuovo su disco tutti i file da minidisco, da nastro o 
nastro a cassetta, i dati iniziano con il primo file sul primo minidisco, bobina nastro 
o nastro a cassetta a meno che non venga indicato un file di inizio differente (una 
data opzionale di file iniziale). Su minidisco il primo file tra tutti i file è anche il primo 
file sui minidisco poiché un insieme di file può essere salvato soltanto su un minidi- 
sco contenente file non scaduti. 


Per ripristinare tutti i file di dati precedentemente salvati: 


#SAVE s2 NOAUTO LEAVE 
S3 UNLOAD 
MI.nn 
M2.nn 
T1 
T2 


RESTORE [aa] sjset namej,,|S1 «| AUTO ,{REWIND|,|nome file iniziate |, 


[asta file iniziare | 





389 


390 





Per ripristinare un singolo file di dati precedentemente salvato: 


RESTORE nome file, |mmggaa |,|, sl, 
ggmmaa RECORDS,record LOCATION,locazione 


aammgg | |BLOCKS,blocchi ,locazione 


s2 
53 
Ml.nn 
M2.nn 
TI 


12 | 


[lunghezza record |, SAME |, [posizione chiave,lunghezza chiave | , 


Sl , AUTO |,|INCLUDE » [posizione]. EQ|, [caratteri | 5 
NOAUTO| |OMIT 


DUPKEY |, {REWIND 
NODUPKEY | |LEAVE 
UNLOAD 


I parametri da 9 (INCLUDE/OMIT) fino a 17 (DUPKEY/NODUPKEY) non sono validi 
quando si ripristina da nastro o nastro a cassetta. 


| ALL specifica che tutti i file precedentemente salvati in un gruppo devono essere 
ripristinati sul disco. Se non viene specificato il primo parametro, si presume ALL. 


nome gruppo specifica il nome usato per l’intero gruppo di file che è stato salvato 
su minidisco, su nastro o nastro a cassetta dalla procedura SAVE (SAVE ALL). 
Se non è indicato alcun nome di gruppo su una specifica RESTORE ALL, viene 
presunto un nome gruppo di #SAVE. 


deve essere ripristinato sul disco. Se esiste più di un file con lo stesso nome 
e se la data di creazione non è indicata, il sistema ripristina il primo file con, 
quel nome che incontra sul minidisco, sul nastro o sul nastro a cassetta. 


mmggaa, ggmmaa o aammgg indica la data di creazione del file su minidisco, su 
nastro o nastro a cassetta. La data deve essere nello stesso formato della data 
di sessione; usare il comando di controllo STATUS SESSION per determinare 


| nome file specifica un singolo file su minidisco, su nastro o nastro a cassetta che 
I il formato della data. 


RECORDS a BLOGKS indica la dimensione per il file, Se non viene specificato 


né BLOCK né RECORDS e non viene indicata la corrispondente dimensione, 
il file viene ripristinato alla sua dimensione originale. Se viene modificata 
l'organizzazione del file e/o la lunghezza dei record, il file ripristinato è reso 
abbastanza ampio per accogliere il numero totale di record presenti nel file 
su minidisco, nastro o nastro a cassetta. 


Nota: Quando viene aggiunto un singolo file su disco ad un file su minidisco 
precedentemente salvato e non viene indicato BLOCKS o RECORDS, l’ag- 
giunta potrebbe impedire il ripristino. Ciò succede in quanto si cerca di ri- 
pristinare più dati nello stesso spazio su disco allocato al file precedentemen- 
te salvato prima dell'aggiunta. 


RECORDS specifica che il file su minidisco deve essere sufficientemente 
ampio per contenere il numero di record specificati. record può essere qual- 
siasi numero da 1 a 8.000.000. 


BLOCKS indica che il file di dati deve essere sufficientemente ampio per ac- 
cogliere il numero di blocchi specificato, blocks può avere qualsiasi valore tra 
1 e il numero massimo di blocchi di memoria disco configurata su! sistema. 


LOCATION specifica la posizione preferita del disco o il primo numero di blocco 


S1, 


per il file. Se non si specifica LOCATION in una locazione associata, il SSP 
inserisce il file sull'unità disco meno usata. 


locazione può essere: 


A1, A2, A3 o A4 indica la preferenza del disco; cioè l'unità disco che viene 
esaminata per prima alla ricerca di spazio disponibile. Se non è disponibile 
sufficiente spazio su quell’unità, vengono esaminate le altre unità (se esistono) 
ed il file viene inserito sull'unità disco meno usata. Se non è specificata 
alcuna locazione il file è ripristinato secondo la preferenza disco del file prima 
che questo fosse salvato se esisteva una preferenza disco. Altrimenti, il file 
è posto sull'ultima unità disco usata. 


A1 specifica che la locazione preferenziale del file su disco è sul primo disco, se 
è disponibile spazio. 


A2 specifica che il file deve essere inserito sul secondo disco, se è disponibile spazio. 
A3 specifica che il file deve essere inserito sul terzo disco, se è disponibile spazio. 


AA specifica che il file deve essere inserito sul quarto disco, se è disponibile spazio. 
numero blocco speeifica la locazione del primo blocco del file. È possibile specifica- 
re un massimo di 6 cifre..E possibile usare la procedura CATALOG per determinare 
dove sono disponibili blocchi di spazio su disco. 


Per ulteriori informazioni sulle locazioni dei file, vedere la Specifica OCL 
FILE (per i file su disco). 


$2 a S3 specifica l'alimentatore a minidischi contenente il primo minidisco 
da elaborare. Se non è specificato alcun parametro si presume S1. 


M1.nn o M2.nn specifica la locazione di caricatore contenente il primo minidisco 


da elaborare. M1 specifica il primo caricatore e M2 il secondo caricatore. nn 
è un numero da 01 a 10 che identifica la locazione del minidisco nel carica- 
tore. Specificare M1 equivale a specificare M1.01:; specificare M2 equivale a 
specificare M2.01. 
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T1, T2 o TC specifica l'unità nastro contenente il primo nastro da elaborare. T1 
indica la prima unità nastro, T2 indica la seconda unità nastro e TC il nastro 
a cassetta. 


AUTO specifica quanto segue: 


Se viene specificato S1, S2 o S3, possono essere usati tutti e tre i singoli 
alimentatori (S1, S2 e S3). L'elaborazione inizia con il minidisco nell‘ali- 
mentatore specificato e continua fino al minidisco nell’alimentatore S3. 
Se occorrono altri minidischi, viene visualizzato un messaggio e l’opera- 
tore deve inserire i successivi minidischi. L'elaborazione riprende col mi- 
nidisco nell’alimentatore S1. 


Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli 
alimentatori di caricatore (M1 e M2}). L'elaborazione inizia con il minidi- 
sco nella locazione specificata e continua fino al minidisco nella locazio- 
ne M2.10. Se occorrono altri minidischi, viene visualizzato un messaggio 
e l'operatore deve inserire i successivi minidischi. L'elaborazione riprende 
alia locazione M1.01 fino a M2.10. 


Se viene specificato T1 o T2, quando la bobina nastro sull'unità nastro 
originale è terminata, il sistema passa all'altra unità nastro, se disponi- 
bile, per continuare l'elaborazione (da T1 a T2 o da T2 a T1). Se l'altra 
unità non è disponibile, verrà usata l’unità originale. Una richiesta verificherà 
che la bobina montata sia quella giusta. 


Se è specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


Se non è specificato alcun parametro, si assume AUTO. 


NOAUTO specifica quanto segue: 


Se viene specificato S1, S2 o S3, può essere usato soltanto l'alimentatore 
specificato. Se occorrono altri minidischi, viene visualizzato un messaggio 
e l'operatore deve inserire il successivo minidisco nell’alimentatore speci- 
ficato. 


Se viene specificato M1.nn o M2.nn, può essere usato soltanto il carica- 
tore specificato. L'elaborazione inizia con il minidisco nella locazione 
specificata e continua fino all'ultimo minidisco nel caricatore. Se occor- 
rono altri minidischi, viene visualizzato un messaggio e l'operatore deve 
inserire il successivo caricatore nell’alimentatore che viene usato. L’elabo- 
razione riprende alla prima locazione nel caricatore, 


Se è specificato T1 o T2, per tutti i volumi di nastro verrà usata soltan- 
to l’unità nastro specificata. 


Se è specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


INCLUDE o OMIT specifica se devono essere inclusi o omessi dal file ripristinato 
record specifici nel file da copiare. | parametri INCLUDE e OMIT, lavorano 
con i parametri posizione, EQ, NE, LT, GT, LE, GE e ‘caratteri’. 


Se viene specificato soltanto ‘characters’ o position, si presume INCLUDE e 


EO. 


pr 


posizione specifica, per ciascun record, il primo carattere da paragonare con | ca- 


EQ 


NE 


LT 


LE 


GT 


GE 


ratteri di confronto, Posizione può avere qualsiasi valore da 1 a 4096, Se non 
viene specificata una posizione, ogni posizione nel record viene paragonata 
con i caratteri di confronto fino a che la condizione specificata non viene 


soddisfatta. 


specifica che se i caratteri ne! record indicati da posizione sono identici ai ca- 
ratteri di confronto, il record deve essere incluso o omesso dal file ripristi- 
nato, 


specifica che se i caratteri nel record indicati da posizione non sono gli stessi 
dei caratteri di confronta, il record deve essere incluso od omesso dal file ri- 
pristinato. 


specifica che se i caratteri nel record indicati da posizione sono minori dei ca- 
ratteri di confronto, il record deve essere incluso 0 omesso dal file ripristi- 
nato. 


specifica che se i caratteri nel record indicati da posizione sono minori o iden- 
tici ai caratteri di confronto, il record deve essere incluso o omesso dai file 
ripristinato. 


specifica che se i caratteri nel record indicati da posizione sono maggiori dei 
caratteri di confronto, il record deve essere incluso o omesso dal file ripri- 
stinato, 


specifica che se i caratteri nel record indicati da posizione sono maggiori di o 
identici ai caratteri di confronto, il record deve essere incluso o omesso dal 
file ripristinato. 


‘caratteri’ specifica i caratteri di confronto. E’ possibile specificare fino a 30 ca- 


lunghezza record indica la lunghezza di record del file ripristinato e può essere . 


ratteri che devono essere racchiusi tra apici (‘). Possono essere compresi spazi 
in bianco e virgole (,) ma gli apici non possono essere compresi come dati. 


qualsiasi numero da 1 a 4096. Se non viene immesso questo parametro, co- 
me iunghezza di record del file ripristinato viene usata quella del file ripristinato. 


Se la lunghezza del record del file su minidisco è minore di quella specificata, 
le ulteriori posizioni di record nel file ripristinato sono riempite con spazi in bianco. 
Se la lunghezza dei record del file su minidisco è maggiore di quella specifica- 
ta, le posizioni extra nel file sono troncate. Se il file ripristinato è un file a indici 
e il campo chiave è troncato, viene visualizzato un messaggio per consentire 
all'operatore di cancellare il lavoro. 


SAME specifica che il file ripristinato deve avere la stessa organizzazione che il 


file aveva quando è stato salvato: Se non è specificato un parametro, si pre- 
sume SAME, 


8 specifica che il file ripristinato deve essere organizzato come file sequenziale. 


1 specifica che il file ripristinato deve essere organizzato come un file a indice. 


D specifica che il file ripristinato deve essere organizzato come un file diretto. 
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posizione chiave specifica la posizione iniziale della chiave per il file ripristinato. 
La posizione della chiave deve essere specificata se il file ripristinato deve 
essere modificato in un fite a indice da un file sequenziale o da un file diret- 
to (e cioè quando è specificato 1). Inoltre, se si ripristina un file a indice, è 
possibile specificare un altro campo per la chiave. La posizione di chiave può 
essere-qualsiasi numero da 1 a 4096. L'intera chiave, definita dalla posizione 
e dalla lunghezza di chiave, deve essere nell'ambito del record, 


Se non viene specificato un valore e il file che si sta ripristinando è un file 
a indice, si presume la posizione di chiave del file a indice salvata. Se viene 
specificata una posizione di chiave, deve essere specificata anche la lunghezza 
di chiave. 


lunghezza chiave specifica la lunghezza della chiave per il file ripristinato. Deve 
essere specificata la lunghezza della chiave se il file ripristinato deve essere 
modificato in un file a indice da un file diretto o sequenziale (e cioè quando 
è specificato I). Inoltre, se si sta ripristinando un file a indice, è possibile 
specificare un altro campo per la chiave. La lunghezza di chiave può essere 
qualsiasi numero da 1 a 120. L'intera chiave, definita dalla posizione e dalla lun- 
ghezza di chiave, deve essere all’interno del record. 


Se non viene specificato un valore e il file che si sta ripristinando è un file 
a indice, si presume la lunghezza di chiave del file a indice salvata. Se è spe- 
cificata una lunghezza di chiave, deve essere specificata anche la posizione di 
chiave. 


DUPKEY specifica che nel file a indici che viene creato possono essere ammesse 
chiavi doppie. Se il file che viene creato non è a indici, questo parametro è 
ignorato, Se questo parametro non viene specificato l'attributo del file di im- 
missione è identico all’attributo del file di emissione. 


NODUPKEY specifica che nel file a indici che viene creato le chiavi doppie non 
sono ammesse. Se .il file che viene creato non è a indici, questo parametro è 
ignorato. Se questo parametro non è specificato, l'attributo dei file di immis- 
.sione è identico all’attributo del file di emissione. 


REWIND specifica che il nastro o nastro a cassetta deve essere riavvolto all’inizio 
dopo aver eseguito la procedura RESTORE. Si presume REWIND se questo pa- 


rametro non viene specificato. 


LEAVE specifica che il nastro o nastro a cassetta deve essere lasciato dov'è dopo 
che è stata eseguita la procedura RESTORE. L'operazione successiva inizia da 
questa posizione. 


UNLOAD specifica che il nastro deve essere riavvolto e scaricato dopo che è stata 
eseguita la procedura RESTORE. Se sono specificati UNLOAD e TC, il nastro 
verrà riavvolto dopo l'elaborazione. 


nome file iniziale specifica il file su minidisco, nastro o nastro a cassetta nel gruppo 
di file dove il sistema inizierà il ripristino. Tutti i file posizionati dopo, verranno 
ripristinati. Se non viene specificato alcun parametro, il sistema inizia il ripristi- 
no con il primo file di gruppo. 


SR 


data file inziale specifica la data di creazione del fite iniziale su minidisco, nastro 
o nastro a cassetta specificato dal nome file iniziale, La data deve avere lo stesso 
formato di quella sessione; si può usare il comando di controllo STATUS SES- 
SION per determinare il formato della data. Se viene specificata la data del file 
iniziale, anche detto file deve essere specificato. 


Esempio 1 
Questo esempio mostra come ripristinare tutti i file che erano stati salvati su mi- 
nidisco usando la procedura SAVE ALL. | minidischi sono negli alimentatori di 
caricatore M1 e M2 e il modulo a minidischi deve automaticamente avanzare a 
M2 dopo l'elaborazione dei minidischi in M1. 


RESTORE ALL,,,Ml 


Esempio 2 


Questo esempio mostra come ripristinare su disco un file denominato PAYROLL 
da minidisco. Il file è disposto su un minidisco nell'alimentatore S1. 


RESTORE PAYROLL 


Esempio 3 
Questo esempio mostra come ripristinare parte di un gruppo di file che erano stati salva- 


ti su minidisco con la procedura SAVE ALL. Tutti i file dopo FILEA (con FILEA compreso) 
vengono ripristinati. 


RESTORE ALL,,,,,,FILEA 


Esempio 4 


Questo esempio mostra come ripristinare da nastro un file su disco denominato 
PAYROLL. Il nastro è montato sull'unità 1. 


| RESTORE PAYROLL,,,,,,T1 


| Esempio 5 


| Questo esempio mostra come ripristinare un file denominato PAYROLL da nastro 
a cassetta su disco. 


| RESTORE PAYROLL,,,,,,IC 
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Esempio 6 


L'esempio che segue è basato su un file su minidisco denominato FILE1 che con- 
tiene i seguenti cinque record. Il file è del tipo a indice, la lunghezza record dei 
file è 60 e la chiave per l'indice è nelle posizioni da 1 a 4. 


Nome file Data file OrganizzazioneLung.chiavePos.chi. Lunghezza record Unità Data Ora Pagina - 1 
FILE 15/09/83 INDEXED 4 1 60 Il 20/09/83 09.43.13 
REG NO: <LINENO» dsc. ciente ae PO ie erat Bert One Ot IO RES ..100 
1 1 0001SAMPLE DATA 4512 - 18TH AVE NW NEW YORK, NY 
2 1 0002MORE SAMPLE DATA 100 - MAIN ST N CHICAGO, IL 
3 1 0003CUSTOMER 1 321% - STH ST NE NEW YORK, NY 
4 1 0004CUSTOMER 2 201% - LTH ST NE NEW YORK, NY 
5 1 O000SCUSTOMER 3 3018 - STH ST NE CHICAGO, IL 


TOTAL RECORDS PRINTED - 5 


Questo esempio mostra come ripristinare il file denominato FILE1. La chiave de- 
ve essere modificata dalle posizioni da 1 a 4 alle posizioni da 5 a 24 e devono es- 
sere copiati soltanto quei record che contengono la frase ‘NEW’, ovunque nel re- 
cord. 


RESTORE FILEl,,,,,,91 ,NOAUTO, INCLUDE, ,EQ,'NEW',,1,5,20 


FILE1 contiene ora i seguenti record: 


Nome file Data file OrganizzazioneLung.chiavePos.chi. Lunghezza record Unità - Data Ora Pagina - 1 
FILEl 15/09/83 INDEXED 20 5 60 F1 20/09/83 09.h6.18 
Tusa weslOvasa rensOror One dra O O tr O rir O e Oett rO 100 


KEY - CUSTOMER 1 
LINE NO - 1 0003CUSTOMER 1 3214 - STH ST NE NEW YORK, NY 


KEY - CUSTOMER 2 
LINE NO - 1 O0O04CUSTOMER 2 2014 - LTH ST NE NEW YORK, NY 


KEY - SAMPLE DATA 
LINE NO - 1 0001SAMPLE DATA b512 - 18TH AVE NW NEW YORK, NY 


TOTAL RECORDS PRINTED - 3 
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PROCEDURA RETRIEVE 


la procedura RETRIEVE ripristina un membro di cartella che era stato copiato su mi- 
nidisco, nastro o nastro a cassetta dalla procedura ARCHIVE. Il membro archiviato 
può essere ripristinato nella stessa cartella o in un’altra. Se il membro è ripristinato 
nella stessa cartella, l’indirizzario di quest’ultima viene modificato per rispecchiare 
il membro ripristinato. Se il membro è ripristinato su una cartella differente o ride- 
nominato se ripristinato sulla stessa cartella, l’indirizzario non viene modificato. 


Se il membro di cartella già esiste viene inviato un messaggio: 

® Cancellare la procedura RETRIEVE 

e = Rimuovereil vecchio membro dalla cartella e continuare con la procedura RETRIEVE 
La procedura RETRIEVE esegue il programma di utilità $TMSERV. 


Per ripristinare un membro di cartella da minidisco: 


RETRIEVE nome cartella,nome file,Il, 


[sata archiviazione [none nuovo nenbro | 


RETRIEVE nome cartella,nome cole,[1] 


, 


AUTO 


NOAUTO 





Per ripristinare un membro di cartetla da nastro o nastro a cassetta. 


T2 


[aste archiviazione | [nome nuovo nenbro] 1? 


AUTO 
NOAUTO 


, 


REWIND 
LEAVE 
UNLOAD 
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nome cartella specifica il nome della cartella che dovrà contenere il membro ripristinato. 
nome file specifica il nome del file su cui si trova ii membro da ripristinare. 


11 specifica che il file contenente il membro archiviato è su minidisco. Se non viene 
specificato alcun parametro, viene assunto 11. 


T1,T20 TC specifica che il file contenente il membro archiviato deve essere ripri- 
stinato da nastro. T1 indica l'unità a nastro 1: T2 l’unità a nastro 2; TC l’unità 
nastro a cassetta. 


data archiviazione specifica la data di archiviazione del membro. La data era stata me- 
morizzata nell’indirizzario di cartella al momento dell’archiviazione. Se non viene 
specificato alcun parametro, il sistema ripristina il primo file con il nome indicato 
nel secondo parametro. 


nome nuovo membro specifica il nome che dovrà avere il membro dopo il suo ripristino. 


$1, $2 0 $3 specifica l'alimentatore che contiene il minidisco. Se non viene specificato 
alcun parametro, ed il terzo parametro è 11, viene assunto S1. 


M1.nn o M2.nn specifica il caricatore contenente il primo minidisco. 


AUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, possono essere usati tutti e tre i singoli 
alimentatori (S1, S2 e S3}. L'elaborazione inizia con il minidisco nell'alimenta- 
tore specificato e continua fino al minidisco nell'alimentatore S3. Se occorro- 
no altri minidischi, viene visualizzato un messaggio e l'operatore deve inserire 
i successivi minidischi. L'elaborazione riprende col minidisco nell’alimentatore 
S1. : 


® Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli ali- 
mentatori di caricatore (M1 e M2). L'elaborazione inizia con il minidisco nella 
locazione specificata e continua fino al minidisco nella locazione M2.10. Se 
occorrono altri minidischi, viene visualizzato un messaggio e l'operatore deve 
inserire i successivi caricatori. L'elaborazione riprende alla locazione M1.01. 


e Sevienespecificato T1 o T2, quando la bobina di nastro sull'unità nastro origi- 
nale è terminata, il sistema passa all'altra unità nastro, se disponibile, per con- 
tinuare l'elaborazione (da T1 a T2 o da T2 a T1). Se l'altra unità non è disponibile, 
viene usata l’unità originale. Una richiesta verificherà che la bobina montata 
sia quella giusta. 


e Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


Se non è specificato alcun parametro, si assume AUTO. 


a 


NOAUTO specifica quanto segue; 


e Se viene specificato S1, S2 o S3, può essere usato soltanto l'alimentatore 
specificato. Se occorrono altri minidischi, viene visualizzato un messaggio e 
l'operatore deve inserire il successivo minidisco nell'alimentatore specificato. 


e Se viene specificato M1.nn o M2.nn, può essere usato soltanto il caricatore 
specificato. L'elaborazione inizia con il minidisco nella focazione specificata 
e continua fino all'ultimo minidisco nel caricatore. Se occorrono altri minidi- 
schi, viene visualizzato un messaggio e l'operatore deve inserire il successivo 
caricatore nell'alimentatore che viene usato. L'elaborazione riprende alla pri- 
ma locazione ne! caricatore. 


e Seviene specificato T1 o T2, per tutti i volumi di nastro verrà usata soltanto 
l'unità nastro specificata. 


e  Seèspecificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


REWIND specifica che il nastro deve essere riavvolto dopo il ripristino del membro. 
E valido solo se è specificato T1, T2 o TC. Se non viene specificato alcun pa- 
rametro, viene assunto REWIND, 


LEAVE specifica che il nastro deve essere lasciato dov'è dopo il ripristino del mem- 
bro. L'operazione nastro successiva inizia da questo punto. Questo parametro 
è valido solo se è specificato T1, T2 o TC. 


UNLOAD specifica che il nastro deve essere riavvolto e scaricato dopo il ripristino 
del membro. Questo parametro è valido solo se è specificato T1 o T2. Non 
è valido se è specificato 11. Se sono specificati UNLOAD e TC, il nastro verrà 
riavvolto dopo l'elaborazione. 


Esempio 


Questo esempio mostra come ripristinare un file denominato FILE1 sulla cartella 
FLDR1. 


RETRIEVE FLDR],FILE],Il 
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PROCEDURA RIFILE 


La procedura RJFILE è usata per avviare il programma di utilità del file su disco 
| MSRJE, che consente di convertire dati di perforazione e di stampa scritti su disco 
da MSRJE sotto forma di record non elaborati da 256 caratteri in file che vengono 
definiti dall'utente. È inoltre possibile usare RJFILE per stampare i dati che erano 
scritti su disco da MSRJE sotto forma di record non elaborati da 256 caratteri. Per 
informazioni su MSRIJE e sulla procedura RJFILE, vedere il manuale MSAUE Guide. 


RJIFILE nome file, [pome tabella di controllo | 





nome file specifica il file da usare dal programma di utilità. 
nome tabella di controllo specifica la tabella di controllo da usare del programma di utili- 
tà. Questa tabella è creata dalla procedura RITABLE. Se questo parametro non è 
specificato, il programma utilizza i valori forniti dalla procedura. Vedere la procedu- 
ra RJITABLE. 
Esempio 


Questo esempio mostra la procedura RJFILE che elabora un file denominato 
DATAFILE usando una tabella di controllo denominata CONTROLS. 


RJFILE DATAFILE,CONTROLS 


PROCEDURA RJTABLE 


La procedura RJTABLE crea una tabella di controllo per il MSRJE. Per informa- 
zioni sul MSRJE e sulla procedura RJTABLE, vedere il manuale MSAJE Guide. 


RJTABLE 


La procedura RJTABLE non ha parametri. 


Esempio 
Questo esempio mostra come avviare la procedura RITABLE. 


RJITABLE 
PROCEDURA RPG 


Questa procedura è supportata soltanto per compatibilità con il Sistema/34 della 
IBM. Vedere la Procedura RPGC per il modo in cui compilare i programmi RPG. 
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PROCEDURA RPGC 


La procedura RPGC compila un programma RPG IL. Per informazioni su RPG II, 
vedere il manuale Programmazione RPG Il 


nome membro origine, |libreria membro origine|,|NODSM|, 
libreria corrente DSM 


NOPRINT| |XREF to] | NEP 


PRINT , |NOXREF|,|num.massimo terminali TnowgP 5 
CRT 





Nibreria di emissione » |SOURCE » |DEBUG ; [ampiezza programma |, 
libreria membro origine| |PSOURCE NODEBUG 
— |NOSOURCE 














libreria membro origine 


NOHALT /,| REPLACE E , sare. libreria sottoroutine 4 


HALT NOREPLAC NOLINK| |OBJECT 





GEN ,|ampiezza file di lavoro|],|nome dizionario dati || NOMRO 
NOGEN| |ko MRO 





nome membro origine specifica il membro origine di libreria che contiene le spe- 
cifiche di programma RPG Il. 


libreria membro origine specifica la libreria che contiene il membro origine da 
compilare. Se questo parametro non viene specificato, si presume la libreria 
corrente. 


NODSM specifica che deve essere creato un membro origine non analizzato. Se 
non viene specificato alcun parametro, si presume NODSM. 


DSM specifica che deve essere creato un membro origine analizzato. Vedere il 
manuale Programmazione RPG Il per ulteriori informazioni sul membro ori- 
gine analizzato. 


PRINT specifica che devono essere stampate le liste di compilazione dalla proce- 
dura RPGC, Se non viene specificato alcun parametro, si presume PRINT. 


NOPRINT specifica che non devono essere stampate o visualizzate le liste di com- 
pilazione. 


CRT specifica che le liste di compilazione dalla procedura RPGC devono essere 


visualizzate sull'unità video che sta eseguendo la procedura RPGC. 


NOXREF specifica che la procedura RPGC non deve produrre una lista di riferi- 
menti incrociati del programma RPG Il. Se non viene immesso alcun para- 
metro, si presume NOXREF. 
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XREF specifica che deve essere prodotta une lista di riferimenti incrociati. 


num. massimo terminali specifica il numero massimo di unità video che possono 
usare il programma nello stesso momento. E’ possibile immettere qualsiasi nu- 
mero da 0 a 999, Se il parametro non viene immesso, si presume un valore 
di 0. Un valore di 0 indica che il programma è un programma per terminali 
richiedenti singoli (SRT); e cioè ciascuna unità video che esegue il program- 
ma esegue la propria copia del programma. Un valore di 1 o più indica che 
il programma è un programma per terminali richiedenti multipli (MRT), 


Per ulteriori informazioni sui programmi MRT, vedere il manuale Concepts 
and Programmer's Guide. 


NONEP specifica che il programma non è sempre residente in memoria, Se non è 
immesso alcun parametro, si presume NONEP. 


NEP specifica che il programma deve essere un programma sempre residente in 
memoria. Per ulteriori informazioni sui programmi sempre residenti in me- 
moria vedere il parametro NEP delle Specifiche OCL ATTR. 


libreria di emissione specifica il nome della libreria che deve contenere il pro- 
gramma compilato, Se questo parametro non viene specificato, si presume la 
libreria del membro origine. 


SOURCE, PSOURCE o NOSOURCE specifica l'opzione di stampa da usare invece 
dell'entrata a colonna 11 della specifica di controllo nel programma. Se non 
viene specificato alcun parametro, viene usata l’entrata a colonna 11 della 
specifica di controllo. 


SOURCE specifica che la procedura RPGC deve creare una lista completa di 
compilazione. ; 


PSOURCE specifica che la procedura RPGC deve creare una lista parziale di 
compilazione. 


NOSOURCE specifica che la procedura RPGC non deve creare alcuna lista di 
compilazione. i 


DEBUG o NODEBUG specifica l'opzione di ricerca e correzione degli errori da 
usare invece dell'entrata a colonna 15 della specifica di controllo nel pro- 
gramma origine. Se non viene specificato alcun parametro, viene usato il va- 
lore indicato a colonna 15 della specifica di controllo. 


DEBUG specifica che deve essere usata l'operazione di ricerca e correzione 
degli errori nel programma origine, 


NODEBUG specifica che non deve essere usata l'operazione di ricerca e cor- 
rezione degli errori nel programma origine. 


ampiezza programma specifica la dimensione del programma in K byte (1 K byte 
equivale a 1024 byte) da usare invece della dimensione del programma im- 
messa nelle colonne da 12 a 14 della specifica di controllo nel programma 
origine. La dimensione può essere qualsiasi numero pari da 2 a 64. Se non 
viene specificata alcuna dimensione, viene usata la dimensione indicata nelle 
colonne da 12 a 14 della specifica di controllo. 


NOHALT specifica che il compilatore non deve fermarsi e visualizzare un mes- 
saggio di errore se trova nel programma un errore di terminazione o di av- 
vertimento.Se non viene specificato alcun parametro, si presume NOHALT. 


HALT specifica che deve essere visualizzato un messaggio di errore se nel pro- 
gramma si trova un errore di terminazione o di avvertimento. 


Zam 


REPLACE specifica che se viene creato un membro oggetto o un membro di 
sottoroutine e se nella libreria di emissione esistono già un membro oggetta 
o un membro di sottoroutine con lo stesso name del programma, il pragram- 
ma di recente compilato deve sostituire il membro oggetto o di sottoroutine 
esistente. Non viene visualizzato alcun messaggio per indicare la sostituzione, 
Se non viene specificato alcun parametro, si presume REPLACE. 


NOREPLAC specifica che se viene creato un membro oggetto o un membro di 
sottoroutine e se esiste già nella libreria di emissione un membro oggetto 0 
di sottoroutine con lo stesso nome del programma, deve essere visualizzato 
un messaggio ed è possibile sostituire il membro o cancellare la procedura. 


LINK specifica che deve essere creato un membro oggetto. Questo parametro fa 
sì che venga eseguito l'editore di moduli oggetto per sovrapposizione che 
crea un programma eseguibile. Se non viene immesso alcun parametro, si 
presume LINK. 


NOLINK specifica che non deve essere creato nessun membro oggetto. 


NOOBJECT specifica che non deve essere creato un membro di sottoroutine, Se 
non viene specificato alcun parametro, si presume NOOBJECT. 


OBJECT specifica che deve essere creato un membro di sottoroutine. Questo 
membro deve essere sottoposto a edizione di modulo oggetto usando la pro- 
cedura OLINK o l'editore di moduli oggetto per sovrapposizione prima di 
poter essere eseguito. 


libreria sottoroutine specifica la libreria contenente una o più sottoroutine dell’as- 
semblatore che devono essere associate con il programma che viene compi- 
lato. Se non viene specificato alcun parametro, si presume la libreria del 
membro origine. 


GEN specifica che se il programma RPG che viene compilato contiene un file 
CONSOLE, i tracciati video per quel file CONSOLE devono essere generati 
come parte del processo di compilazione. Se non viene specificato alcun pa- 
rametro, si presume GEN. 


NOGEN specifica che non devono essere generati tracciati video per un file CON- 
SOLE. 


ampiezza file di lavoro indica la dimensione (in blocchi) per i file di lavoro della 
procedura RPGC. Se non viene specificato alcun formato, si presumono 40 
blocchi. 


nome dizionario dati specifica il dizionario dati che contiene la definizione file comunica- 
zioni da usarsi durante la compilazione del programma. 


MRO o NOMRO specifica se il compilatore è da usarsi con strutture overlay resi- 
denti in memoria. Se non viene specificato alcun parametro, viene assunto 
NOMRO. 


MRO specifica che il compilatore è da usarsi con strutture overlay residenti in 
memoria. 


NOMRO specifica che il compilatore non è da usarsi con strutture overlay resi- 
denti in memoria. 


Esempio 


Questo esempio mostra come compilare un programma RPG II denominato PAY- 
ROLL. Il programma è contenuto nella libreria corrente; il membro compilato e 
sottoposto a edizione di moduli oggetto, deve essere inserito nella libreria corren- 
te, Deve essere generata una lista delle specifiche origine e una lista di riferimenti 
incrociati e deve essere usata l'operazione DEBUG. 


RPGC PAYROLL,,,,XREF,,, SOURCE, DEBUG - 
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PROCEDURA RPGLOAD 


La procedura RPGLOAD crea una libreria denominata #RPGLIB e copia il sup- 
porto T “G dal minidisco in quella libreria, RPGLOAD copia ulteriore supporto 
nella libreria di sistema (#LIBRARY). La procedura RPGLOAD può copiare mi- 
nidischi PID (Program Information Department) e minidischi creati dalla proce- 
dura RPGSAVE. Vedere la Procedura RPGSAVE per informazioni sul modo in 
cui salvare ii supporto RPG su minidisco. 


La procedura RPGLOAD potrebbe modificare il record di configurazione princi- 
pale con ii risultato che potrebbe non esserci un membro di configurazione corri- 
spondente. Per modificare il membro di configurazione per adeguarlo al record di 
configurazione principale, vedere il manuale Modifica della configurazione del si- 
stema. Occorre normalmente ‘usare la procedura CNFIGSSP per aggiungere sup- 
porto al sistema. E' possibile usare la procedura RPGLOAD per ripristinare il sup- 
porto che era stato precedentemente salvato con la procedura RPGSAVE. 


Se I'RPG non è in uso corrente sul sistema, è necessario usare la procedura TOLIBR 
per copiare il file RPG su minidisco nella libreria #LIBRARY prima di eseguire 
RPGLOAD. Ì 

Se #LIBRARY con l'RPG era stata salvata e poi ripristinata prima di eseguire 
RPGLOAD, non è necessario copiare il file minidisco RPG con la procedura TOLIBR. 


RPGLOAD 








A1, A2, A3 o A4 indica la preferenza del disco; cioè l’unità disco che viene esa- 
minata per prima alla ricerca di spazio. disponibile. Se non è disponibile spa- 
zio a sufficienza su quell'unità, vengono esaminate altre unità (se esistono) 
e #RGLIB viene inserito sull'unità disco meno usata. Se non è specificata 
alcuna locazione ed il sistema ha più di un'unità disco, #RPGLIB viene 
inserito sull'unità disco meno usata. 


A1 specifica che # RPGLIB deve essere inserita sul primo disco, se è disponibile 
spazio. 


A2 specifica che # RPGLIB deve essere inserita sul secondo disco, se è disponibile 
spazio. 


A3 specifica che # RPGLIB deve essere inserita sul terzo disco, se è disponibile 
spazio. 


A4 specifica che # RPGLIB deve essere inserita sul quarto disco, se è disponibile 
spazio. 


S1, S2 o S3 specifica l'alimentatore del minidisco contenente il primo minidisco 
da usare. Se non è specificata alcuna posizione di minidisco, si presume S1. 
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M1.nn o M2.nn specifica la locazione del caricatore -contenente .il. primo -minidi- 
sco da usare. M1 indica il primo caricatore € M2' indica il secondo caricatore. 
_ nn è un valore decimale da 01 a 10 che identifica la locazione del minidisco 
‘nel caricatore, ‘Specificare Mi equivale: a specificare Mi. 01; specifica M2 

/ equivale a specificare M2. 01. 


Esempio 


Creazione di #RPGLIB su disco e copia del supporto RPG dal minidisco, 


RPGLOAD 
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PROCEDURA RPGONL 


La procedura RPGONL consente di sviluppare un programma RPG. E' possibile 
creare un nuovo programma o effettuare modifiche ad un programma esistente 
e quindi compilare e correggere gli errori nel programma usando la funzione del 
membro origine analizzato del compilatore RPG, 


La procedura RPGONL mostra schermi che consentono di controllare come la 
procedura viene eseguita. E’ possibile terminare la procedura RPGONL da uno 
qualsiasi di questi schermi. 


Vedere il manuale Programmazione RPG I! per ulteriori informazioni su questa 
procedura e sul RPG 


RPGONL 





La procedura RPGONL non ha parametri. 


Esempio 
Per avviare la procedura RPGONL, immettere: 


RPGONL 


PROCEDURA RPGP 
La procedura RPGP visualizza un menù che consente di selezionare la funzione 
RPG Il che si desidera eseguire. E’ possibile immettere, modificare o compilare un 
programma RPG Il. E’ inoltre possibile richiedere una lista di riferimenti incro- 


ciati oppure creare o modificare i tracciati video usati con i programmi RPG Il. 


Vedere il manuale Programmazione RPG il per ulteriori informazioni su questa 
procedura e sul RPG. 


RPGP 


La procedura RPGP non ha parametri, 


Esempio 
Per visualizzare un menù di procedure RPG, immettere: 


RPGP 
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PROCEDURA RPGR 


La procedura RPGR genera membri oggetto e origine di tracciato video per un 
file CONSOLE in un programma origine RPG Il. Per informazioni sul RPG II, 
vedere Îl manuale Programmazione RPG Il. 


RPGR nome membro origine, |ampiezza file di lavoro|,|SAVE 
ho NOSAVE 


libreria membro origine|,|libreria membro oggetto , can |. 


libreria corrente libreria corrente 





REPLACE |,| PRINT 
NOREPLAC NOPRINT 





nome membro origine specifica il membro origine di libreria che contiene le spe- 
cifiche di programma RPG Il, 


ampiezza file di lavoro specifica la dimensione in blocchi del file di lavoro 
$SOURCE, che può avere qualsiasi valore da 1 a 999. Se non viene immes- 
so alcun parametro, si presumono 40 blocchi. 


SAVE indica che devono essere salvate le specifiche origine per ii membro trac- 
ciato video. Se non viene immesso alcun parametro, si presume SAVE. 


NOSAVE indica che le specifiche origine per il membro tracciato video non de- 
vono essere salvate. Verrà creato soltanto il membro oggetto tracciato video, 


libreria membro origine specifica ia libreria che contiene il membro origine RPG. 
Se non è specificato alcun nome di libreria, si presume la libreria corrente. 


libreria membro oggetto specifica la libreria che deve contenere il membro ogget- 


to tracciato video. Se non è specificato alcun nome di libreria, sì presume la 
libreria corrente. 


GEN specifica che devono essere creati i tracciati video per il file CONSOLE. Se 
non viene specificato alcun parametro, si presume GEN. 


REPLACE specifica che deve essere sostituito un membro oggetto di tracciato 
video esìstente con lo stesso nome di nome membro. Se non viene specifi- 
cato alcun parametro, si presume REPLACE. 


NOREPLAC specifica che se esiste già un membro oggetto con lo stesso nome, 
deve essere visualizzato un messaggio ed è possibile continuare la procedura 
o cancellarla, 


PRINT specifica che deve essere stampata una lista dei tracciati video creati. Se 
non viene specificato alcun parametro, si presume PRINT. 


NOPRINT specifica che la lista non deve essere stampata. 
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Esempio 


L'esempio mostra come generare tracciati video del file CONSOLE per un pro- 
gramma RPG Il denominato PAYROLL. 


RPGR PAYROLL 


Sn” 


PROCEDURA RPGSAVE 


La procedura RPGSAVE copia su minidisco il supporto RPG. Viene copiato il 

sin supporto RPG dalle librerie #RPGLIB e FLIBRARY. Per caricare il supporto 
RPG da minidisco di riserva è possibile usare la Procedura RPGLOAD. |l minidisco che 
deve contenere la copia salvata deve avere come ID di volume PPRPG ed essere dispo- 
sto nell’alimentatore del minidisco S1. 


RPGSAVE 
La procedura RPGSAVE non ha parametri. 
Esempio 
Copia del supporto RPG su minidisco. 
RPGSAVE 
PROCEDURA RPGSDA 
La procedura RPGSDA avvia la procedura SDA. Vedere il manuale Guida alla 
definizione dei tracciati video per ulteriori informazioni sul modo in cui usare 
lo SDA e per informazioni sui tracciati video. 
Gun Vedere il manuale Programmazione RPG Il! per ulteriori informazioni su questa 
procedura e sul RPG. 
RPGSDA 


La procedura RPGSDA non ha parametri. 


Esempio 
Per avviare la procedura RPGSDA, immettere: 


RPGSDA 
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PROCEDURA RPGSEU 


La procedura RPGSEU consente di creare o modificare un programma o proce- 
dura RPG Il usando il SEU. Per informazioni sul RPG Il, vedere il manuale Pro- 
grammazione RPG Il. Per ulteriori informazioni sul SEU, vedere il manuale 
Programma di utilità per l'immissione di dati origine (SEU). 


LO 


nome membro,|R|,jmembro formati seu [Lunghezza specifica |, 
#SEQXTRA 


nome libreria 
libreria corrente 








nome membro specifica il membro di libreria da creare o modificare, 


R. specifica un membro origine RPG Il. Se non viene specificato alcun parame- 
tro,.viene presunto R. 


A specifica un membro origine RPG Il contenente specifiche di auto report. 
P_ specifica un membro di procedura. 


membro formati seu specifica il nome del membro oggetto che contiene tracciati 
video SEU. Se non viene specificato alcun parametro, si presume #SE@XTRA. 
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lunghezza specifica specifica la lunghezza per ciascuna specifica di procedura o 
origine. Può essere un qualsiasi numero da 40 a 120. Se il membro esiste, si 
presume la lunghezza della specifica del membro. Se il membro viene creato, 
i. valori che è possibile specificare e i valori ehe sono assunti dal SEU se non 
è indicata alcuna lunghezza di specifica, sono i seguenti: 


Lunghezza specifica Lunghezza specifica 
Tipo membro ammessa assunta 


da 80 a 96 
da 80 a 96 








da 40 a 120 





nome iibreria specifica la libreria che contiene o conterrà il membro che viene 
modificato o creato. Se non viene specificato alcun nome di libreria, si presu- 


me la libreria corrente. 


Esempio 


Questo esempio mostra come usare la procedura RPGSEU per modificare un 
membro origine RPG Il denominato PAYROLL. La libreria corrente contiene il 


membro origine. 


RPGSEU PAYROLL 
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PROCEDURA RPGX 


La procedura RPGX crea una lista di riferimenti incrociati per un programma 
RPG Il (senza compilare il programma). Per informazioni sul RPG Il vedere il 
manuale Programmazione RPG Il 


RPGX nome membro origine,|ampiezza file di lavoro|,|libreria membro origine 


Lo libreria corrente 





Se si immette la procedura RPGX senza parametri uno schermo consente di im- 
metterli, 


nome membro origine specifica il membro origine che contiene le specifiche di 
programma RPG Il. 


ampiezza file di lavoro specifica la dimensione del file di lavoro $SOURCE in 
blocchi e può essere qualsiasi numero da 1 a 999. Se non viene immesso 
alcun parametro, si presumono 40 blocchi. 

libreria membro origine specifica il nome della libreria che contiene il membro 


origine di cui si deve eseguire la lista di riferimenti incrociati. Se questo 
parametro non viene specificato, si presume la libreria corrente. 


Esempio 


Questo esempio mostra come creare una lista di riferimenti incrociati per un pro- 
gramma RPG Il denominato PAYROLL. 


RPGX PAYROLL 


PROCEDURA SAVE 


La procedura SAVE consente di: 


e Salvare su minidisco, su nastro o nastro a cassetta un singolo file di disco. La 
procedura SAVE può anche essere usata per selezionare record da salvare (sol- 
tanto quando si salva un singolo file su minidisco senza operazioni ADD). 


e Aggiungere un altro file su disco ad un file su disco già salvato su minidisco, 
e Salvare su minidisco, su nastro 0 nastro a cassetta, un gruppo di file specificati. 


e Salvare su minidisco, su nastro o nastro a cassetta, tutti i file su disco (com- 
© presi i gruppi di file). 


e Salvare su minidisco, nastro 0 nastro a cassetta, tutti i file su disco {esclusi 
i gruppi di file) 


@ Salvare su minidisco i file in una forma compressa sostituendo i caratteri che 
si ripetono con caratteri di controllo. 


e Salvare gruppi di file multipli su nastro o nastro a cassetta. 


La procedura SAVE salva soltanto i file di dati utente. Per salvare una libreria su 
minidisco, su nastro o nastro a cassetta, vedere la Procedura SA VELIBR. Per salva- 
re una cartella su minidisco, nastro o nastro a cassetta, vedere la Procedura SA VE- 
LIBR. Per salvare l’indirizzario risorse rete sul minidisco, nastro 0 nastro a cassetta, 
vedere la Procedura SAVENRD. Per salvare il file cronologico di sistema su minidi- 
Sco, su nastro o nastro a cassetta, eseguire per prima cosa la procedura HISTORY 
per copiare il file cronologico su un file su disco quindi eseguire la procedura SAVE 
per salvare su minidisco, su nastro o nastro a cassetta quel file; vedere la Procedu- 
ra HISTORY per ulteriori informazioni. 


La procedura SAVE può essere utilizzata per salvare individualmente file remoti su 
minidischi locali. Vedere il manuale Distributed Data Management Guide. 


I nomi di file che contengono un punto definiscono gruppi di file. { caratteri che 
precedono il punto identificano il gruppo di file e i caratteri che lo seguono iden- 
tificano il file nell'ambito del gruppo. Come per tutti i nomi file, il numero mas- 
simo di caratteri è 8, compreso il punto. | file con nomi che non contengono un 
punto non fanno parte di un gruppo. Esempi di nomi di file nell'ambito di un 
gruppo di file, sono: 


PAYROL.A 
PAYROL.B File nel gruppo di file PAYROL 
PAYROL.C 


A.ACCTS 

A_.INV 

A.PROLL File nel gruppo di file A 
A.B.GO 

A.B.INV 


A.B.GO i PRI 
A.B.INV } File nel gruppo di file A.B 
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La procedura SAVE può essere usata per salvare un file che viene usato da un 
altro lavoro sul sistema se la specifica FILE di quel lavoro indica DIP-SHRRR o 
DISP-SHRRM. Vedere la Specifica OCL FILE (per i file su disco) per ulteriori 
informazioni sulla condivisione dei file. 


La procedura SAVE può essere eseguita da qualsiasi unità video. Se viene usata la 
procedura SAVE per copiare tutti i file su disco (è specificato-ALL come primo 
e quinto parametro), la procedura può essere eseguita soltanto se non ci sono la- 
vori che operano aggiunte o modifiche ai file su disco esistenti (altri lavori posso- 
no leggere o creare nuovi file). Se ci sono dei file a cui vengono fatte aggiunte o 
modifiche, viene visualizzato un messaggio ed è possibile riprovare di nuovo la 
procedura SAVE o cancellarla. 


Tutti i file esistenti prima di immettere la procedura SAVE possono essere sal- 
vati. In ogni caso, qualsiasi file creato durante l'operazione di salvataggio può o 
meno essere salvato in relazione al fatto che la sua creazione sia terminata nel 
momento in cui si verifica il salvataggio. 


La procedura SAVE non può essere usata per salvare una libreria, o una cartella. Vedere 
la Procedura SAVELIBR per informazioni sul salvataggio di librerie. Vedere la procedura 
SAVEFLDR per informazioni sul salvataggio di cartelle. 


Quando si copiano su minidisco, nastro o nastro a cassetta, tutti i Membri di uno 
specifico gruppo di file, tutti i file su disco inclusi i gruppi di file o tutti i file su disco 
esclusi i gruppi di file, si crea un insieme di file su minidisco, nastro o nastro a 


cassetta. 
Quando si crea questo insieme di file su minidisco, i minidischi riceventi devono es- 
sere vuoti; non devono contenere file con date di scadenza ancora valide. 


trebbe contenere file o gruppi di file con date scadenza valida salvati precedente- 


| Quando si crea l'insieme di file su nastro, o nastro a cassetta, il primo di questi po- 
mente; pertanto l'utente dovrà prestare attenzione ai file o gruppi di file duplicati. 


| La procedura SAVE esegue il programma di utilità $COPY. $ COPY non elabora li- 
brerie, cartelle o file di sistema. 


| È possibile copiare sui nastri o nastro a cassetta che seguono se il primo file di ognuno 
di essi ha la data scaduta. 


| Per salvare su minidisco, su nastro o nastro a cassetta un file su disco: 


nome file,|jgiorni di valiaità),|mmggaa]|, id volume,|Sl » | AUTO 
1 ggmmaa S2 NOAUTO 
aammgg 83 
Ml.nn 
M2.nn 
TI 
T2 


NOREORG]| , | INCLUDE , [posizione |, EQ|, [caratteri ,{ REWIND |, |[NOCOMPRESS 


NE LEAVE COMPRESS 


UNLOAD 


REORG OMIT 
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Per aggiungere un file su disco a un file su minidisco: 


egmmaa 92 NOAUTO 


aammgg 


nome file ,ADD,|mmggaa |, id volume,| Sl 5 no ) 





Per salvare solo i file su disco di un gruppo di file: 








[ana] (£ nina Gi validità|, nome gruppo|, id volume,gruppo file, SL 
#SAVE 









NOAUTO| |LEAVE COMPRESS 


(n s {REWIND}, a 
UNLOAD 


Per salvare tutti i file su disco compresi i file che appartengono ad un gruppo: 


[ana]; [e giorni di validità|,|nome gruppo| ,id volume ,ALL,|S1 ,s |AUTO 5 
#SAVE S2 NOAUTO 


53 
Ml.nn 
M2.nn 
TI 
T2 


LEAVE 
UNLOAD 


COMPRESS 


REWIND|, pn] 





411 


412 


Per salvare tutti i file su disco salvo i file che appartengono ad un gruppo: 





SAVE 


[aux] »|giornì di valiaità],|]nome gruppo |,id volume,,|S1 3 


1 





#SAVE s2 


[REWIND |, | NOCOMPRESS 


LEAVE. 
UNLOAD 


$3 
Ml.nn 
M2.nn 


m 
L 


te 


COMPRESS | 





I parametri da 7 a 11 non sono validi per il salvataggio su nastro, l'aggiunta ad 
un file su minidisco o il salvataggio di file multipli. 


nome file specifica un file su disco da salvare. Il nome file del minidisco sarà lo 


stesso nome del file del disco, 


ALL specifica quanto segue: 


e Se è specificato ALL come primo e quinto parametro, tutti i file su di- 
sco vengono copiati, che esistano o meno gruppi di file. 


e Se è specificato ALL come primo parametro e nulla è specificato come 
quinto parametro, vengono salvati tutti i file che non sono membri di 
gruppi. 


e Se è specificato ALL come primo parametro ed è specificato un gruppo 
di file come quinto parametro, vengono salvati tutti i membri di quel 
gruppo di file. 


Se non sono specificati i parametri, si presume ALL. 


Se il primo parametro è ALL o non è specificato, i minidischi o le bobine 
di nastro sui quali i file vengono copiati non possono contenere file attivi. 


giorni di validità indica per quanti giorni deve essere conservato il file e può avere 


qualsiasi valore da 1 a 999. Se il periodo di validità non è specificato, si presu- 
me un giorno. Se è specificato un periodo di validità di 999 giorni, il file su mi- 
nidisco, su nastro o nastro a cassetta è considerato un file permanente. Per 
ulteriori informazioni sulla validità dei file su minidisco o nastro, o nastro a cas- 
setta, vedere la Specifica OCL FILE (per i file su minidisco) o la Specifica OCL 
FILE (per i file su nastro). 


ADD specifica che un singolo file su disco deve essere aggiunto ad un file pre- 


cedentemente salvato su minidisco. il file‘su minidisco al quale viene effet- 
tuata l'aggiunta deve essere l'ultimo sul minidisco. E’ possibile usare la pro- 
cedura CATALOG {per listare i file su minidisco per locazione), per deter- 
minare se il file al quale si vuole aggiungere è l’ultimo sul minidisco. 


Notare che se viene specificato ADD, non è possibile specificare i parametri 
da 7 a 11, Inoltre, ADD può essere specificato solo per minidisco e non per 
nastro o nastro a cassetta. 


AUTO 
NOAUTO 





2 





de 


nome gruppo specifica il nome associato con l’intera serie di file salvati. Se non 
viene specificato alcun nome, viene usato #SAVE. 


mmggaa, ggmmaa o aammgg specifica la data di creazione del file su disco. La 
data deve essere nello stesso formato della data di sessione; usare il comando 
di controllo STATUS SESSION per determinare il formato della data. Se 
‘non è specificata la data di creazione ed esiste più di un file con il nome spe- 
cificato, viene salvato il file più recente. 


id volume indica ID del volume del minidisco, della bobina nastro o del nastro a 
cassetta. È possibile specificare da 1 a 6 caratteri alfanumerici. 


gruppo file specifica il nome del gruppo di file da salvare. ll punto (.) che indica 
un nome di gruppo di file non deve essere specificato. Per esempio, per sal- 
vare i file che appartengono al gruppo che comprende PAYROL.A, PAY- 
ROL.B e PAYROL.C, occorre immettere PAYROL per questo parametro. 


S1, S2 o S3 specifica l'alimentatore a minidischi contenente il primo minidisco 
da elaborare. Se non è specificato aicun parametro si presume S1. 


M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidi- 
sco da elaborare. M1 indica il primo caricatore e M2 indica il secondo cari- 
catore. nn è un numero da 01 a 10 che identifica la locazione del minidisco 
nei caricatore. Specificare M1 equivale a specificare M1.01; specificare M2 
equivale a specifica M2.01. 


T1,T20TC specifica l’unità nastro il primo nastro da elaborare. T1 indica la prima 
unità nastro, T2 indica la seconda unità nastro, e TC indica il nastro a cassetta. 


AUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, è possibile usare tutti e tre i singoli 
alimentatori (S1, S2 e S3). L'elaborazione inizia con il minidisco nel- 
l'alimentatore specificato e continua fino al minidisco nell’alimentatore 
S3. Se occorrono altri minidischi, viene visualizzato un messaggio e 
l'operatore deve inserire i successivi minidischi. L'elaborazione riprende 
col minidisco nell’aliméntatore S1. 


e Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli 
alimentatori di caricatore (M1] e M2). L'elaborazione inizia con il mini- 
disco nella locazione specificata e continua fino al minidisco nella loca- 
zione M2.10. Se occorrono altri minidischi, viene visualizzato un mes- 
saggio e l'operatore quindi inserisce i successivi caricatori. L'elaborazione 
riprende alla locazione M1.01, 


e Se viene specificato T1 o T2, quando la bobina nastro sull'unità nastro 
originale è terminata, il sistema passa all'altra unità nastro, se disponibi- 
le, per continuare l'elaborazione (da T1 a T2 o da T2 a T1). Se l'altra 
unità nastro non è disponibile, viene usata l'unità nastro originale. 
Viene inviata una richiesta per verificare l'esattezza del montaggio della bo- 
bina. 


e Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


Se non è specificato alcun parametro, si presume AUTO. 
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NOAUTO specifica quanto segue: 


e Se viene specificato S1, S2 o $3, può essere usato soltanto l'alimentato- 
re specificato. Se occorrono altri minidischi, viene visualizzato un mes- 
saggio e l'operatore deve inserire il successivo minidisco nell’alimentato- 


re specificato. 


e Se viene specificato M1.,nn o M2.nn, può essere usato soltanto il carica 
tore specificato. L'elaborazione inizia con il minidisco nella locazione 
specificata e continua fino all'ultimo minidisco nel caricatore. Se sono 
necessari altri minidischi, viene visualizzato un messaggio e l'operatore 
deve inserire il successivo caricatore nell’alimentatore che viene usato. 
L'elaborazione riprende alla prima locazione nel caricatore. 


e Se viene specificato T1 o T2, per tutti i volumi di nastro verrà usata sol. 
tanto l’unità nastro specificata. 


e Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


Ogni volta che viene eseguita la procedura SAVE, il primo minidisco o nastro 
destinato a ricevere l'emissione deve essere nella locazione specificata. Se il 
minidisco o nastro in quella locazione non è in grado di ricevere l'emissione, 
il sistema non cerca nei successivi alimentatori o ‘unità a nastro un minidisco 
o nastro valido. Per contro, viene visualizzato un messaggio di errore e l’opera- 
tore deve inserire un minidisco o nastro in grado di ricevere l'emissione nell’ali- 
mentatore o unità a nastro specificato oppure cancellare la procedura. 


NOREORG specifica che il file non deve essere riorganizzato. Cioè per i file 


RE 


sequenziali e a indice, qualsiasi record cancellato è salvato unitamente ai 
record che contengono i dati. Per i file diretti, i record cancellati sono 
sempre salvati. Inoltre, per i file-a indice i record devono essere salvati 
nell'ordine -in cui si presentano nel file. 


ORG specifica che il file deve essere riorganizzato. Cioè per i file a indice e 
sequenziali, non sono salvati i record che sono stati cancellati ma sono sal- 
vati soltanto i record che contengono dati, Per i file diretti, i record cancel- 
lati sono sempre salvati. Inoltre, per i file a indice, i record devono essere 
salvati sequenzialmente per chiave. Se è specificato T1, T2 o TC, REORG non 
è consentito. 


INCLUDE o OMIT specifica se record specificati nel file devono essere inclusi o 


omessi dal salvataggio. i parametri INCLUDE e OMIT, lavorano con i para- 
metri posizione, EQ, NE, LT, GT, LE, GE e ‘caratteri’. Se sono specificati 
soltanto ‘caratteri’ o posizione, si presumono INCLUDE e EQ. INCLUDE e OMIT 
non sono consentiti se il salvataggio è su nastro o nastro a cassetta. 


posizione specifica, per ciascun record, il primo carattere da paragonare con la 


EO 


NE 


posizione iniziale dei-caratteri di confronto. Posizione può assumere qualsiasi 
valore da 1 a 4096. Se non viene specificata una posizione, ogni posizione 
nel record è paragonata con il carattere di confronto. Questo parametro non 
è consentito se il salvataggio è su nastro o nastro a cassetta. 


specifica che se i caratteri nel record indicati da posizione sono gli stessi dei 
caratteri di confronto, il record deve essere incluso 0 omesso dal salvataggio. 


specifica che se i caratteri nel record indicati da posizione non sono gli stessi 
dei caratteri di confronto, il record deve essere incluso o omesso dal salvatag- 
gio. Questo parametro non è consentito se il salvataggio è su nastro o nastro 
a cassetta. 


x 


LT specifica che se i caratteri nel record indicati da posizione sono minori dei 
caratteri di confronto, il record deve essere incluso o omesso dal salvataggio. 
Questo parametro non è consentita se il salvataggio è su nastro o nastro a 
cassetta. 


LE specifica che se i caratteri nel record indicati da posizione sono minori o u- 
guali ai caratteri di confronto, il record deve essere incluso o omesso dal sal- 
vataggio. Questo parametro non è consentito se il salvataggio è su nastro o 
nastro a cassetta. 


GT specifica che se i caratteri nel record indicati da posizione sono maggiori dei 
caratteri di confronto, il record deve essere incluso o omesso dal salvataggio. 
Questo parametro non è consentito se il salvataggio è su nastro o nastro a 
Cassetta. 


GE specifica che se i caratteri nel record indicati da posizione sono maggiori o 
uguali ai caratteri di confronto, il record deve essere incluso o omesso dal 
salvataggio. Questo parametro non è consentito se il salvataggio è su nastro 
o nastro a cassetta. 


‘caratteri’ specifica i caratteri di confronto. E’ possibile specificare fino a 30 ca- 
ratteri che devono essere racchiusi tra apici (’). Nella stringa di caratteri è 
possibile specificare qualsiasi carattere salvo gli apici. Questo parametro non 
è consentito se il salvataggio è su nastro o nastro a cassetta. 


REWIND specifica che il nastro o nastro a cassetta deve essere riavvolto dopo aver 
eseguito la procedura SAVE. Si presume REWIND se questo parametro non viene 
specificato. 


LEAVE specifica che il nastro o nastro a cassetta deve essere lasciato dov'è dopo 
l'esecuzione della procedura SAVE. La successiva operazione su nastro inizia 
da questa posizione. 


UNLOAD specifica che il nastro deve essere riavvolto e scaricato dopo l’esecuzio- 
ne della procedura SAVE. Se sono specificati UNLOAD e TC, il nastro verrà 
riavvolto dopo l'elaborazione. 


NOCOMPRESS specifica che i dati non vengono compressi quando un file su disco vie- 
ne salvato su minidisco. Il file su minidisco ha lo stesso formato di quello su disco. 


COMPRESS specifica che i dati vengono compressi quando un file su disco è salvaco 
su un minidisco. | caratteri ripetuti vengono rimpiazzati da caratteri di controllo. Quando 
il file viene ripristinato i dati vengono messi di nuovo nel loro originale formato. La com- 


pressione dei file fa risparmiare spazio sul minidisco. Se viene specificato COMPRESS 
valgono ie seguenti restrizioni: 


®* COMPRESS non è consentito se si specifica T1, T2 o TC. 


e I file deve essere salvato su minidisco 2D inizializzato FORMAT2 (1024 byte per 
settore) 


e = record non possono essere selezionati o riorganizzati. 


® Unfile su disco da aggiungere ad un file su minidisco non può essere compresso 
e non può essere aggiunto ad un file su minidisco compresso. 


*e Un file compresso non può essere ripristinato su un Sistema/32 o Sistema/34. 


® Un file compresso non può essere visualizzato utilizzando le procedure LISTDATA 
o LISTFILE. 
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Esempio 1 
Salvataggio su minidisco di tutti i file su disco per un periodo di 7 giorni. | mi- 
nidischi hanno un ID di volume di VOL001 e sono dislocati nei caricatori M1 e 
M2, iniziando nella posizione M1.01. 


SAVE ALL,7,,VOLOO1,ALL,M1,AUTO 


Esempio 2 


Salvataggio di un file denominato FILE1 e aggiunta di questo file a un file su 
minidisco esistente denominato FILE1. L’ID di volume dei minidisco è VOL001. 


SAVE FILEl,ADD,,VOLOOLl 


Esempio 3 


Salvataggio di.tutti i file che appartengono al gruppo di file PAYROL. Il nome 
da associare con la serie di file salvati è PAYROL. L’ID di volume del minidisco 
è VOLOO?2 e il file deve essere salvato per almeno un mese (33 giorni). | file sono compressi. 


SAVE ALL,33,PAYROL, VOLOO2, PAYROL ;, , , COMPRESS 


Esempio 4 


Salvataggio su minidisco di record specifici da un singolo file denominato FILE3. 
I soli record da salvare contengono la parola SAVE nelle posizioni da 10 a 13 del 


record. 


SAVE FILF3,,,VOLOO1,,,,INCLUDE,10,EQ,'SAVE' 


Esempio 5 
Salvataggio di tutti i file che non erano gruppi di file sul volume nastro VOLO001, 
che è montato sull'unità nastro T1. Quando la bobina su T1 è piena, deve essere 
usata la bobina su T2 (se il nome della bobina di nastro è VOL0O01 e se su di es- 
sa non esistono file). 


SAVE ALL,,;VOL001,,T1,AUTO, REWIND 


Esempio 6 
Salvataggio di un file denominato FILE1 sulla bobina di nastro VOL001 montata 
sull'unità nastro T2. Se occorrono ulteriori bobine di nastro per accogliere il file, 
usare soltanto l’unità nastro 2. Inoltre, non riavvolgere il nastro dopo il salvatag- 
gio del file, 


SAVE FILEl,,,VOLOO1,T2,NOAUTO,,,,,,LEAVE 


Esempio 7 


Salvataggio di un file su disco denominato FILE1 su un nastro a cassetta con ID 
di volume TEST1. Il file su nastro dovrà essere un file permanente, 


SAVE FILE1,999,,TEST1,TC 


PROCEDURA SAVEFLDR 


La procedura SAVEFLDR salva l'intero contenuto di una cartella su minidisco, na- 
stro o nastro a cassetta. 


Per ripristinare una cartella copiata su minidisco, nastro o nastro a cassetta, dalla 
procedura SAVEFLDR vedere la procedura RESTFLDR, 


La procedura SAVEFLDA esegue il programma di utilità $TMSERV. 


SAVEFLDR nome cartella,jgiorni ,ID volume,ijI1},|Sî «| AUTO ‘ 


conservazione TI S2 NOAUTO 
299 T2 s3 

Ml.nn 

M2.nn 


REWIND |, | NOCOMPRESS 


LEAVE 


COMPRESS 


UNLOAD 





nome cartella specifica la cartella da salvare su minidisco, nastro o nastro a casset- 
ta. Il file su minidisco o nastro contenente la cartella da copiare deve avere lo 
stesso nome della cartella. Per informazioni più dettagliate vedere il manuale 
Concepts and Programmer's Guide . 


giorni di conservazione indica per quanti giorni deve essere conservata la cartella 
e può avere qualsiasi valore da 1 a 999. Se il periodo di validità non è specifi- 
cato, si presume un giorno. Se è specificato un periodo di validità di 999 gior- 
ni, fa cartella su minidisco, su nastro o nastro a cassetta, è considerata una 
cartella permanente. Per ulteriori informazioni sulla validità delle cartelle su di- 
sco, su minidisco o nastro a cassetta, vedere la Specifica OCL CARTELLA (per 
le cartelle su minidisco) o la Specifica OCL CARTELLA (per le cartelle su nastro). 


id volume indica l'ID di volume del minidisco, della bobina o del nastro a cassetta. 
E possibile specificare da 1 a 6 caratteri alfanumerici. Se "ID di volume non 
viene specificato, verrà fatta richiesta di immetterlo. 


11 specifica che la cartella deve essere salvata su minidisco. 


T1, T2 o TC specifica che la cartella deve essere salvata su nastro. T1 indica la 
prima unità nastro, T2 indica la seconda unità nastro, TC il nastro a cassetta. 


S1,S2 0 S3 specifica l'alimentatore a mindischi contenente il primo minidisco da 
elaborare. Se non viene specificato alcun parametro, si presume S1. Questo 
parametro è consentito soltanto se nel parametro 4 è indicato 11. 


{M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidisco da 
elaborare. M1 indica il primo caricatore e M2 indica il secondo, nn è un numero 
da 01 a 10.che identifica la locazione del minidisco nel caricatore. Specificare M1 
equivale a specificare M1.01; specificare M2 equivale a specificare M2.01. Se vie- 
ne specificato T1 o T2 nel settimo parametro, questo parametro viene ignorato. 


AUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, possono essere usati tutti e tre i singoli 
alimentatori (S1, S2 e S3). L'elaborazione inizia con il minidisco nell’alimenta- 
tore specificato e continua fino al minidisco nell'alimentatore S3. Se occorro- 
no altri minidischi, viene visualizzato un messaggio e l'operatore deve inserire 
i successivi minidischi. L'elaborazione riprende col minidisco nell'alimentatore 


S1. 


416.1. 
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e Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli ali- 
mentatori di caricatore (M1 o M2). L'elaborazione inizia con il minidisco nella 
locazione specificata e continua fino al minidisco nella locazione M2.10. Se 
occorrono altri minidischi, viene visualizzato un messaggio e l'operatore deve 
inserire i successivi caricatori. L'elaborazione riprende alla locazione M1.01. 


e Sevienespecificato T1 o T2, quando la bobina di nastro sull'unità nastro origi- 
nale è terminata, il sistema passa all'altra unità nastro, se disponibile, per con- 
tinuare l'elaborazione {da T1 a T2 o da T2 a T 1). Se l'altra unità non è disponibile, 
viene usata l'unità originale. 


e Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l'unità nastro a cassetta. 


Se non è specificato alcun parametro, si assume AUTO. 


NOAUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, può essere usato soltanto l'alimentatore 
specificato. Se occorrono altri minidischi, viene visualizzato un messaggio e 
l'operatore deve inserire il successivo minidisco nell’alimentatore specificato. 


e Se viene specificato M1.nn o M2.nn, può essere usato soltanto il caricatore 
specificato. L'elaborazione inizia con il minidisco nella locazione specificata 
e continua fino all'ultimo minidisco nel caricatore. Se occorrono altri minidi- 
schi, viene visualizzato un messaggio e l'operatore deve inserire il successivo 
caricatore nell’alimentatore che viene usato. L'elaborazione riprende alla pri- 
ma locazione nel caricatore. 


e Seviene specificato T1 o T2, per tutti i volumi di nastro verrà usata soltanto 
l'unità nastro specificata. 


| e Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


REWIND specifica che il nastro deve essere riavvolto dopo l'esecuzione della pro- 
| cedura SAVEFLDR. Questo parametro è valido solo se è specificato T1, T2 o 
TC. Se non viene specificato alcun parametro, viene assunto REWIND. 


LEAVE specifica che il nastro deve essere lasciato dov'è dopo l'esecuzione della 
procedura SAVEFLDR. La successiva operazione su nastro inizia da questa po- 
| sizione. Questo parametro è valido solo se è specificato T1, T2 o TC. 


UNLOAD specifica che il nastro deve essere riavvolto e scaricato dopo l’esecuzio- 
ne della procedura SAVEFLDR. Questo parametro non è consentito se è speci- 
ficato !1. Se sono indicati UNLOAD e TC, il nastro verrà riavvolto dopo 
l'elaborazione. 


NOCOMPRESS specifica che i contenuti della cartella non vengono compressi quando 
la cartella è salvata su minidisco. La cartella su minidisco ha lo stesso farmato di 
quelia su disco. 


COMPRESS specifica che i contenuti di una cartella vengono compressi quando una 
cartella è salvata su minidisco. | caratteri ripetuti vengono rimpiazzati da caratteri 
di controllo. Quando la cartella viene ripristinata, il suo contenuto viene di nuovo 
messo nel suo formato originale. La compressione di una cartella fa risparmiare spazio 
su minidisco. 
Se viene specificato COMPRESS valgono le seguenti restrizioni: 
e COMPRESS non è consentito con T1, T2 o TC. 


e Lacartella deve essere salvata su un minidisco 2D inizializzato FORMAT2. (1024 
byte per settore). 
Esempio 


Salvataggio di una cartella denominata MYFLDR su minidisco con ID di volume IBMIRD. 
La cartella deve essere compressa 


SAVEFLDR MYFLDR,999,IBMIRD,,,, ,COMPRESS 
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PROCEDURA SAVELIBR 


SAVELIBR 


La procedura SAVELIBR salva su minidisco, su nastro o nastro a cassetta, il conte- 
nuto di una libreria. Vengono salvati tutti i membri della libreria, unitamente alla di- 
mensione della libreria ed alla dimensione del suo indirizzario. Se la libreria contiene 
membri forniti dalla IBM, sono salvati anche quei membri. 


Per riprisunare una libreria copiata su minidisco, nastro o nastro a cassetta, dalla 
procedura SAVELIBR, vedere la procedura RESTLIBR. 


È possibile copiare su minidisco, su nastro o nastro a cassetta, uno o più membri 
di libreria usando la procedura FROMLIBR ma in tal caso vengono copiati soltanto 
i membri; le dimensioni della libreria e dell’indirizzario non sono salvate. Vedere la 
Procedura FROMLIBR per ulteriori informazioni sulla copia dei soli membri di libreria. 


La procedura SAVELIBR esegue il programma di utilità $MAINT. 


nome libreria [giorni di validità|,id volume,|Sl 

libreria corrente | ll s2 
L S3 

Ml.nn 

M2.nn 


Il1|,{ REWIND 
Tl| | LEAVE 
T2| | UNLOAD 


nome libreria specifica la libreria da salvare su minidisco, su nastro o nastro a cas- 
setta. Il file su minidisco, su nastro o nastro a cassetta, contenente la libreria, 
assume lo stesso nome della libreria. Se il nome della libreria non è indicato, 
si presume la libreria corrente. Per salvare su minidisco Ia libreria del sistema, 
immettere # LIBRARY. La libreria di sistema non può essere salvata su nastro 
o nastro a cassetta. 


giorni di validità specifica per quanto tempo (in giorni) deve essere conservato il 
file su minidisco, su nastro o nastro a cassetta, contenente la libreria e può 
assumere qualsiasi valore da 1 a 999. Se non viene specificato il periodo di 
validità, si presumono 999 giorni e in tal caso il file è considerato permanente. 
Per ulteriori informazioni sulla validità dei file su minidisco, su nastro o nastro 
a cassetta, vedere la Specifica OCL FILE (per i file su minidisco) e la Specifica 
OCL FILE [per i file su nastro). 


id volume specifica "ID di volume del minidisco, del nastro o del nastro a cassetta. 
E possibile specificare da 1 a 6 caratteri alfanumerici. Se non è specificato al- 
cun ID di volume, viene richiesto di immetterne uno. 


S1, S2 o S3 specifica l'alimentatore del minidisco contenente il primo minidisco 
da elaborare. Se non è specificato alcun parametro si presume S1. Questo pa- 
rametro non è consentito se è specificato T1, T2 o TC. 


M1.nn o M2.nn specifica ia locazione del caricatore contenente il primo minidi- 
sco da elaborare. M1 indica il primo caricatore e M2 indica il secondo cari- 
Catore. nn è un numero da 01 a 10 che identifica la locazione del minidisco 
nel caricatore. Specificare M1 equivale a specificare M1.01; specificare M2 
equivale a specifica M2.01. 


Questo parametro non è consentito se è specificato T1, T2 o TC. 


AUTO 
NOAUTO 
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AUTO specifica quanto segue: 


e Se viene specificato S1, S2 o $3, possono essere usati tutti e tre i singo- 
li alimentatori (S1, S2 e S3). L'elaborazione inizia con il minidisco nel- 
l'alimentatore specificato e continua fino al minidisco nell’alimentatore 
S3. Se occorrono altri minidischi, viene visualizzato un messaggio e 
l'operatore deve inserire i successivi minidischi, L'elaborazione riprende 
col minidisco nell’alimentatore S1. 


e Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli 
alimentatori di caricatore (M1 e M2). L'elaborazione inizia con il mini- 
disco nella locazione specificata e continua firio ai minidisco nella loca- 
zione M2.10. Se occorrono altri minidischi, viene visualizzato .un mes- 
saggio e l'operatore quindi inserisce i successivi caricatori. L'elaborazione 
riprende alla locazione M1.01. . 


e Se viene specificato T1 o T2, quando ia bobina nastro sull'unità nastro 
originale è terminata, il sistema passa all'altra unità nastro, se disponibi- 
le, per continuare l'elaborazione (da T1 a T2 o da T2 a T1). Se l’altra 
unità nastro non è disponibile, viene usata l’unità nastro originale. 
Viene inviata una richiesta per verificare l'esattezza della bobina montata. 


e Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


Se non è specificato alcun parametro, si presume AUTO. 
NOAUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, può essere usato soltanto l’alimentato- 
re specificato. Se occorrono altri minidischi, viene visualizzato un mes- 
saggio e l'operatore deve inserire il successivo minidisco nell'alimentato- 
re specificato. 


e Se viene specificato M1.nn o M2.nn, può essere usato soltanto il carica 
tore specificato. L'elaborazione inizia con il minidisco nella locazione 
specificata e continua fino all'ultimo minidisco nel caricatore. Se sono 
necessari altri minidischi, viene visualizzato un messaggio e l'operatore 
deve inserire il successivo caricatore nell’alimentatore che viene usato. 
L'elaborazione riprende alla prima locazione nel caricatore. 


e Se è specificato T1 o T2, verrà usata per tutti i volumi di nastro soltan- 
to l’unità nastro specificata. 


e  Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


11 specifica che la libreria deve essere salvata su minidisco. 


T1,T20 TC specifica che la libreria deve essere salvata su nastro. T1 indica che il 
nastro è montato sull’unità nastro 1. T2 indica che il nastro è montato sull’uni- 
tà nastro 2. TC indica che il nastro è un nastro a cassetta. 


REWIND specifica che il nastro deve essere riavvolto dopo aver eseguito la procedu- 
ra SAVELIBR. Si presume REWIND se questo parametro non viene specificato. 
Questo parametro non è consentito se è specificato 11. 


LEAVE Specifica che il nastro deve essere lasciato dov'è dopo che è stata eseguita 
la procedura SAVELIBR. La successiva operazione su nastro inizia da questa 
posizione. Questo parametro non è consentito se è specificato 11, 


UNLOAD specifica che il nastro deve essere riavvolto e scaricato dopo che è stata 
eseguita la procedura SAVELIBR. Questo parametro non è consentito se è spe- 
cificato 11. Se sono indicati UNLOAD e TC, il nastro verrà riavvolto dopo l’ela- 
borazione. 


Esempio 1 


Salvataggio permanente di una libreria denominata MYLIB su un minidisco con 
Pen un ID di volume di VOLO001. II minidisco destinato a contenere la libreria è di- 
sposto nell’alimentatore S1, 


SAVELIBR MYLIB,999,VOLOO1 


Esempio 2 


Salvataggio della libreria di sistema su un minidisco con un ID di volume di 
SYSTEM, | minidischi destinati a contenere la libreria sono disposti nell’alimen- 
tatore M1, iniziando dalla posizione M1.01. 


SAVELIBR #LIBRARY, ,SYSTEM,ML 


Esempio 3 


Salvataggio della libreria denominata PAYLIB su un nastro con un ID di volume 
di PAYROL. | nastri destinati a contenere la libreria sono inseriti nell'unità na- 
stro 1 e 2 iniziando con l'unità nastro 2. Una volta che libreria è stata salvata, il 
nastro deve essere scaricato. 


SAVELIBR PAYLIB, ,PAYROL, ,AUTO,T2,UNLOAD 
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SAVENRD 


419.1 


PROCEDURA SAVENRD 


La procedura SAVENRD salva l'indirizzario risorse rete su minidisco, nastro o nastro 
a cassetta. Se l'indirizzario è salvato su nastro, questo deve avere una identificazio- 
ne standard. L'indirizzario può essere salvato con il nome #NRD.FLE (è il nome as- 
sunto) o con altri nomi. 


La procedura SAVENRD può essere eseguita da qualsiasi unità video. L'indirizzario non 
può essere salvato se nel frattempo viene usato da un altro utente o lavoro.. 


Per maggiori informazioni vedere il manuale ‘’Distributed data management guide”. 


La procedura SAVENRD esegue il programma di utilità $COPY. 


giorni 


HI SUTO #(RENIND 5 conservazione 


nome filelj, ID volume, H " noauTO || LEAVE 


T2 unLoan | | 999 





# NRD.FLE specifica che il nome dell’indirizzario (# NRD.FLE) deve essere lo stesso 
di quello salvato su disco. Se non viene specificato alcun parametro, viene assunto 
# NRD.FLE. 


nome file specifica il nome con cui l’indirizzario è stato salvato su minidiscc 
o nastro. 


id volume specifica l'ID del minidisco o della bobina. Possono essere specificati da 1 
a 6 caratteri alfanumerici. 


11 specifica che l'indirizzario deve essere salvato su minidisco. Se non viene specificato 
alcun parametro, viene assunto S1. 


T1, T2 o TC specifica che l'indirizzario deve essere salvato su nastro. T1 indica 
che il nastro è montato sull'unità 1. T2 sull'unità 2. TC indica che il nastro è 
un nastro a cassetta. 


S1, S2 o S3 specifica l'alimentatore a mindischi contenente il primo minidisco da 
elaborare. Se non viene specificato alcun parametro, si presume S1. Se viene 
specificato T1, T2 o TC, questo parametro non è consentito. 


M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidisco 
da elaborare. M1 indica il primo caricatore e M2 indica il secondo, nn è un nu- 
mero da 01 a 10 che identifica la locazione del minidisco nel caricatore. Speci- 
ficare M1 equivale a specificare M1.01; specificare M2 equivale a specificare 
M2.01. Se viene specificato T1, T2 o TC, questo parametro non è consentito. 


AUTO specifica quanto segue: 


® Se viene specificato S1, S2 o S3, possono essere usati tutti e tre i singoli 
alimentatori (S1, S2 e S3). L'elaborazione inizia con il minidisco nell'alimenta- 
tore specificato e continua fino al minidisco nell’alimentatore S3. Se occorro- 
no altri minidischi, viene visualizzato un messaggio e l'operatore deve inserire 
i successivi minidischi. L'elaborazione riprende cot minidisco nell’alimentatore 
S1. 


* Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli ali- 
mentatori di caricatore (M1 o M2). L'elaborazione inizia con il minidisco nella 
locazione specificata e continua fino al minidisco nella locazione M2.10. Se 
occorrono altri minidischi, viene visualizzato un messaggio e l'operatore deve 
inserire i successivi caricatori. L'elaborazione riprende alla locazione M1.01. 


e Sevienespecificato T1 o T2, quando la bobina di nastro sull'unità nastro origi- 
nale è terminata, il sistema passa all'altra unità nastro, se disponibile, per con- 
tinuare l'elaborazione (da T1 aT2 o da T2 a T1). Se l’altra unità nan è disponibile, 
viene usata l’unità originale. 

e Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


Se non è specificato alcun parametro, si assume AUTO. 


NOAUTO specifica quanto segue: 


e Se viene specificato S1, 52 o S3, può essere usato soltanto l'alimentatore 
specificato. Se occorrono altri minidischi, viene visualizzato un messaggio e 
l'operatore deve inserire il successivo minidisco nell’alimentatore specificato. 


€ Se viene specificato M1.nn o M2.nn, può essere usato soltanto il caricatore 
specificato. L'elaborazione inizia con il minidisco nella locazione specificata 
e continua fino all'ultimo minidisco nel caricatore. Se occorrono altri minidi- 
schi, viene visualizzato un messaggio e l'operatore deve inserire il successivo 
caricatore nell'alimentatore che viene usato. L'elaborazione riprende alla pri- 
ma locazione nel caricatore. 


e Seviene specificato T1 o T2, per tutti i volumi di nastro verrà usata soltanto 
l'unità nastro specificata. 

e Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


Ogni volta che viene eseguita la procedura SAVENRD, il primo minidisco che riceve 
l'emissione deve essere in un alimentatore ben specificato. Se il minidisco posto 
in questa posizione da errore, il sistema non cerca nell’alimentatore successivo un 
altro minidisco in buone condizioni. Pertanto l'operatore riceverà un messaggio e 
dovrà provvedere a sostituire il minidisco danneggiato o a cancellare !a procedura. 


REWIND specifica che il nastro deve essere riavvolto dopo l'esecuzione della proce- 
dura SAVENRD. Questo parametro è valido solo se è specificato T1,T20TC . 
Se non viene specificato alcun parametro viene assunto REWIND. 


LEAVE Specifica che il nastro deve essere lasciato dov'è dopo l'esecuzione della 
procedura SAVENRD. La successiva operazione su nastro inizia da questa posi- 
zione. Questo parametro è valido solo se è specificato T1, T2 o TC. 


UNLOAD specifica che il nastro deve essere riavvolto e scaricato dopo l'esecuzione 
della procedura SAVENRD. Questo parametro non è consentito se è specifica- 
to 11. Se sono indicati UNLOAD e TC, il nastro verrà riavvolto dopo l’elabora- 
zione. x 

giorni di conservazione indica per quanti giorni deve essere conservato il file e può 
avere qualsiasi valore da 1 a 999. Se il periodo di validità non è specificato, si pre- 
sume un giorno. Se è specificato un periodo di validità di 999 giorni, il file su minidi- 
sco o su nastro è considerato un file permanente. Per ulteriori informazioni sulla 
validità dei file su disco o su minidisco, vedere la Specifica OCL FILE (per i File 
su Minidisco) o la Specifica OCL FILE (per i File su Nastro). 


Esempio 1 


Questo esempio salva l’indirizzario (# NRD.FLE) su un minidisco posto nell’alimentato- 
re 2. L’ID di volume è VOLO01. L'indirizzario è salvato come file permanente. 


SAVENRD  NRD.FLE,VOLOOL,,52 

Esempio 2 
Questo esempio salva l’indirizzario NRD.BKUP su una bobina {BKUP04) montata sull'u- 
nità nastro T1. Terminato il salvataggio, la bobina deve essere riavvolta e scaricata. 


Il file deve essere conservato per un anno. 


SAVENRD NRD.BKUP,BKUPO4,T1,, )UNLOAD, 365 
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PROCEDURA SDA 
La procedura SDA avvia il programma SDA. E’ possibile usare to SDA per: 
e Creare o modificare menù o tracciati video 
e  Aiutarea creare programmi WSU e RPG 
e  Correggere membri di libreria usando il SEU 
e Visualizzare tracciati video 
e Stampare tracciati video 


e Generare membri oggetti di tracciato video usando il programma di utilità 
$SFGR. 


L'SDA fa parte del programma di utilità su licenza. Per ulteriori informazioni sul 
modo in cui usare l'SDA e sui tracciati video e menù, vedere il manuale Guida a/- 
la definizione dei tracciati video. 


nome membro formati! .,|libreria d'immissione|,,|N 
nome menù libreria corrente Y 
sa i PARTIAL 





libreria di emissione|,|libreria membro oggetto formati video 
libreria d'immissione{ |libreria d'immissione 








Tutti i parametri della procedura SDA sono facoltativi e sono usati per stabilire 
i valori assunti per difetto che compaiono sugli schermi successivi presentati dal- 
lo SDA. 


nome membro formati o nome menù specifica il membro origine tracciati video o 
menù che si desidera modificare o creare. li nome del membro tracciati può 
contenere al massimo 8 caratteri; il nome del menù può contenere fino a 6 
Caratteri. 


libreria d’immissione specifica il nome della libreria che contiene o conterrà i 
membri origine menù o tracciato video. Questo parametro specifica anche la 
libreria da analizzare alla ricerca di membri oggetto di tracciato video quando 
si visualizzano i tracciati contenuti in un membro oggetto. Se non viene spe- 
cificato questo parametro, si presume la libreria corrente. 


La posizione 3 è per compatibilità con il Sisterna/34 della IBM. Questa posizione 
è ignorata. 


420 


Psi 


N specifica che devono essere listati soltanto i messaggi di errore e le righe conte- 
nenti l'errore quando vengono generati i tracciati video. Se non viene specifi- 
cato alcun parametro, si presume N. 


Pat 


Y_ specifica che deve essere listato l’intero membro origine tracciato video unita 
mente a qualsiasi errore quando vengono generati i tracciati video. 


PARTIAL specifica che deve essere listato un elenco parziale del membro origine 
tracciato video quando vengono generati i tracciati video, 


libreria di emissione specifica il nome della libreria che deve contenere il menù 
È modificato o creato oppure l'origine per il tracciato video modificato o crea- 


to, Se non viene specificato alcun nome di libreria, si presume la libreria di 
immissione. 


libreria membro oggetto formati video specifica il nome della libreria che deve 


contenere il membro oggetto tracciati video modificato o creato, Se non 
viene specificato alcun nome di libreria, si presume la libreria di immissione. 


Esempio 
Questo esempio mostra come avviare l'SDA. 


SDA 


421 


PROCEDURA SDALOAD 


La procedura SDALOAD crea una libreria denominata #SDALIB e vi copia il 
supporto SDA da minidisco. SDALOAD copia ulteriore supporto nella libreria di 
sistema {#LIBRARY). La procedura SDALOAD può copiare minidischi PID 
(Program Information Department} o minidischi creati dalla procedura SDASAVE. 
Vedere la Procedura SDASAVE per informazioni sul modo in cui salvare il sup- 
porto SDA su minidisco. 


La procedura SDALOAD potrebbe modificare il record di configurazione princi- 
pale, con il risultato che potrebbe non esserci un membro di configurazione cor- 
rispondente. Per modificare il membro di configurazione per adeguarlo al record 
di configurazione principale, vedere il manuale Modifica della configurazione del 
sistema. Occorre normalmente usare la procedura CNFIGSSP per aggiungere sup- 
porto al sistema. E’ possibile usare la procedura SDALOAD per ripristinare il sup- 
porto che era stato precedentemente aggiunto. 


per copiare il file SDA su minidisco nella libreria #LIBRARY prima di eseguire 


Se I'SDA non è in uso corrente sul sistema, è necessario usare la procedura TOLIBR 
| SDALOAD. 


Se #LIBRARY con lo SDA era stata salvata e poi ripristinata prima di eseguire SDA- 
LOAD, non è necessario copiare il file SDA su minidisco con la procedura TOLIBR. 


SDALOAD 





A1, A2, A3 o AA indica la preferenza del disco; cioè l’unità disco che viene esa- 
minata per prima alla ricerca di spazio disponibile. Se non è disponibile spa- 
zio a sufficienza su quell'unità, vengono esaminate altre unità (se esistono) 
e #SDALIB viene inserito suli'unità disco meno usata. Se non è specificata 
alcuna locazione ed il sistema ha più di un'unità disco, #SDALIR viene 
inserito sull’unità disco meno usata. 


A1 specifica che #SDALIB deve essere inserita sul primo disco, se è disponibile 
spazio. 


A2 specifica che #SDALIB sarà inserito sul secondo disco, se è disponibile spazio. 
A3 specifica che #SDALIB sarà inserito sul terzo disco, se è disponibile spazio. 
A4 specifica che #SDALIB sarà inserito sul quarto disco, se è disponibile spazio. 


S1, S2 o S3 specifica l'alimentatore del minidisco contenente il primo minidisco 
da usare. Se non è specificata alcuna posizione di minidisco, si presume S1. 


Mi.nn o M2.nn specifica la locazione del caricatore contenente il primo minidi- 
sco da elaborare. M1 indica il primo caricatore e M2 indica il secondo cari- 
catore. nn è un numero da 01 a 10 che identifica la locazione del minidisco 
nel caricatore. Specificare M1 equivale a specificare M1.01; specificare M2 
equivale a specifica M2.01. 
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SDASAVE 


Esempio 
Creazione di #SDALIB su disco e copia da minidisco dal supporto SDA. 


SDA LOAD 


PROCEDURA SDASAVE 


La procedura SDASAVE copia su minidisco il supporto SDA. Viene copiato il 
supporto SDA dalle librerie #SDALIB e #LIBRARY. E’ possibile usare la Proce- 
dura SDALOAD per caricare il supporto SDA da minidisco di riserva. Il minidisco che 
deve contenere la copia salvata deve avere come ID di volume PPUTIL ed essere dispo- 


sto sull’alimentatore S1.— 


La procedura SDASAVE non ha parametri. 


Esempio 


Copia del supporto SDA su minidisco. 


SDASAVE 
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PROCEDURA SECDEF 
La procedura SECDEF consente di fare quanto segue: 
e Creare o rimuovere il file di identificazione dell'utente 
e Creare o rimuovere il file di riservatezza sulle risorse 
e  Attivareo disattivare la riservatezza mediante parola d'ordine 
e Attivareo disattivare la riservatezza mediante tessera di riconoscimento 
e Attivareo disattivare la riservatezza sulle risorse. 


e Avviareo arrestare il controllo data parola d'ordine. 


Per ulteriori informazioni su questi file e sul modo in cui eseguire la procedura 
SECDEF, vedere il manuale Pianificazione della Riservatezza. 


Se è attiva la riservatezza mediante parola d'ordine, soltanto il responsabile prin- 
cipale della riservatezza può eseguire la procedura SECDEF. Se non è attiva la ri 
servatezza mediante parola d'ordine, la procedura SECDEF può essere eseguita 
soltanto dalla console di sistema. 


La procedura SECDEF esegue il programma di utilità $PRUID o $RRESC, a seconda cel 
parametro indicato. 


Per definire la riservatezza mediante parola d’ordina: 


SECDEF USERID|,} CREATE 
DELETE 


ACTPW 
DEACTPW 


ACTBDG 

DEACTBDG 
STRTDATE 
STOPDATE 





Per definire la riservatezza sulle risorse: 





SECDEF RESOURCE, |CREATE 
DELETE 


ACTRES 
DEACTRES 
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USERID specifica che deve essere definito il file di identificazione dell'utente o 

che deve essere attivata o disattivata la riservatezza mediante parola d'ordine 
o tessera di riconoscimento. Se non viene specificato alcun parametro, si pre- 
TE sume USERID. 


Se non viene immesso un secondo parametro, viene visualizzato un menù 
esplicativo che elenca le opzioni per SECDEF USERID. Se viene immesso un 
secondo parametro, compare uno schermo di richieste, 


CREATE visualizza una richiesta che consente di creare il file ID dell’utente, 


DELETE visualizza una richiesta che consente di cancellare il fite 1D dell’u- 
tente. 


ACTPW visualizza una richiesta che consente di attivare la riservatezza me- 
diante parola d’ordine. 


DEACTPW visualizza una richiesta che consente di disattivare la riservatezza 
mediante parola d'ordine. 


ACTBDG visualizza una richiesta che consente di attivare la riservatezza me- 
diante tessera di riconoscimento, 


DEACTBDG visualizza una richiesta che consente di disattivare la riservatez- 
za mediante tessera di riconoscimento. 


| STRTDATE visualizza una richiesta che consente di avviare la funzione con- 
trollo parola d’ordine. 


| STOPDATE visualizza una richiesta che consente di arrestare la funzione con- 
trollo parola d'ordine. 


RESOURCE specifica che deve essere definito il file di riservatezza sulle risorse 
o che la riservatezza sulle risorse deve essere attivata o disattivata. 


Se non viene immesso il secondo parametro, viene visualizzato un menù 
esplicativo che elenca le opzioni per SECDEF RESOURCE, Se viene immes- 
so Un secondo parametro, compare lo schermo delle richieste. 


CREATE visualizza una richiesta che consente di creare il file di riservatezza 
sulle risorse. 


DELETE visualizza una richiesta che consente di cancellare il file di riserva- 
tezza sulle risorse. 


ACTRES visualizza una richiesta che consente di attivare la riservatezza sulle 
risorse. 


DEACTRES visualizza una richiesta che consente di disattivare la riservatezza 
sulle risorse. 


Esempio 


Questo esempio mostra come avviare la procedura SECDEF per lavorare con il fi- 
le di identificazione dell'utente. 


SECDEF 


Si vedrà quindi un menù esplicativo dal quale è possibile selezionare una delle op- 
zioni. 
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PROCEDURA SECEDIT 


La procedura SECEDIT consente di aggiungere, rimuovere o aggiornare entrate 
nel file di identificazione dell'utente o nel file di riservatezza sulle risorse. 


Per profili utente in un file di identificazione dell'utente: se è attiva la riservatezza 
mediante parola d'ordine, soltanto il responsabile principale della riservatezza o il re- 
sponsabile della riservatezza possono eseguire la procedura SECEDIT con indicato il 
parametro USERID per aggiungere, rimuovere o aggiornare profili utente nel file di 
identificazione dell'utente. Se è attiva la riservatezza mediante parola d'ordine, ogni 
utente può eseguire la procedura SECEDIT con indicato il parametro USERID, per 
modificare il proprio profilo utente. Se non è attiva la riservatezza mediante parola 
d'ordine, la procedura SECEDIT con indicato il parametro USERID può essere ese- 
guita soltanto dalla console di sistema. 


Per profili ubicazione nel file identificazione utente: se è attiva la riservatezza mediante 
parola d'ordine, soltanto il responsabile principale della riservatezza o il responsabile 
della riservatezza può eseguire la procedura SECEDIT con indicato il parametro COMM 
per aggiungere, rimuovere o aggiornare i profili ubicazione nel file di riservatezza sulle 
risorse. Se non è attiva la riservatezza mediante parola d'ordine, la procedura SECEDIT 
non può essere eseguita con indicato il parametro COMM. 


Per ulteriori informazioni su questi file e sul modo in cui usare la procedura 
SECEDIT, vedere il manuale Pianificazione della Riservatezza. 


SECEDIT USERID 
RESOURCE 


COMM 
OFFICE 





USERID specifica che si desidera aggiungere, rimuovere o aggiornare profili utente 
nel file di identificazione dell'utente. Se non viene specificato alcun parametro, si 
‘presume USERID. 


RESOURCE specifica che si desidera aggiungere, rimuovere o aggiornare entrate nel file 
di riservatezza sulle risorse per file, librerie e gruppi. 


COMM specifica che si vuole aggiungere, rimuovere, o variare i profili ubicazione nel 
file identificazione utente. 


OFFICE specifica che si vuole aggiungere, rimuovere o variare la lista autorizzazioni o 


l’informazione di riservatezza per cartelle nel file riservatezza risorse, o l'informazione 
di riservatezza per membri di cartella. 


Esempio 


Questo esempio mostra come avviare la procedura SECEDIT per modificare 
un'entrata nel file di identificazione dell'utente, 


SECEDIT 


Vedere il manuale Pianificazione della Riservatezza per informazioni sull’esecu- 


zione di SECEDIT, 
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PROCEDURA SECLIST 


La procedura SECLIST fornisce una lista del file di identificazione dell'utente e 
una lista del file di riservatezza sulle risorse, 


Per profili utente nel file di identificazione dell'utente: se è attiva la riservatezza median- 
te parola d’ordine, soltanto il responsabile principale della riservatezza o il responsabile 
della riservatezza possono eseguire la procedura SECLIST con indicato ii parametro USE- 
RID per listare i profili utente del file ID dell'utente. Se non è attiva la riservatezza me- 
diante parola d'ordine, la procedura SECLIST può essere eseguita soltanto dalla console 
di sistema. 


Per profili ubicazione nel file identificazione utente: se è attiva la riservatezza mediante 
parola d'ordine, soltanto il responsabile principale della riservatezza può eseguire la pro- 
cedura SECLIST con indicato il parametro COMM, per listare i profili ubicazione del file 
identificazione utente. Se non è attivata la riservatezza mediante parola d'ordine, la pro- 
cedura SECLIST non può essere eseguita con il parametro COMM. 


% 


Per il file di riservatezza sulle risorse: se è attiva la riservatezza mediante parola 
d'ordine, soltanto ii responsabile principale delia riservatezza o il responsabile 
della riservatezza possono eseguire la procedura SECLIST per listare le informa- 
zioni nel file di riservatezza sulle risorse. Se non è attiva la riservatezza mediante 
parola d'ordine, la procedura SECLIST può essere eseguita soltanto dalla console 
di sistema per fistare tutte le informazioni nel file di riservatezza sulle risorse. | 
proprietari delle risorse possono listare le informazioni per tutte le proprie risorse 
in qualsiasi momento. 


Per informazioni sulla riservatezza e per le descrizioni delle liste create da questa 
procedura, vedere il manuale Pianificazione della Riservatezza. 


La procedura SECLIST esegue il programma di utilità $PRCLT, $PRLST, $RRLST, o 
$RRTLT, a seconda dei parametri specificati. 


Per listare profili utente nel file di identificazione dell'utente: 


SECLIST USERID,|PRINTER|,j NOPW|,| USERID 


SECLIST COMM, 


CRT PW CLASS 


Per listare profili ubicazione nel file di identificazione utente 


PRINTER 


CRT 
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PW specifica che le parole d'ordine possono essere listate. Quando è attiva la ri- 
servatezza mediante parola d'ordine, il responsabile principale della riserva 
tezza può listare tutte le parole d'ordine nel file, Il responsabile della riserva- 
tezza può listare soltanto le parole d'ordine degli operatori con una classifi- 
cazione di riservatezza di operatore di sistema o inferiore. Le parole d'ordine 


non possono essere listate se non è attiva la riservatezza mediante parola 
d'ordine. 


OWNERID specifica che le risorse devono essere listate alfabeticamente per ID 
del proprietario. Se non viene specificato alcun parametro, si presume OW- 
NERID. 


RNAME specifica che le risorse devono essere listate per nome di risorsa. Se viene spe- 
cificato RNAME, non può essere specificato USER; deve essere invece specificato ALL. 


USERID specifica che l'emissione o le risorse devono essere listate alfabeticamen- 
te per ID dell'utente. Se è specificato SECLIST USERID, l’emissione è stampa- 
ta in ordine alfabetico di ID utente. Se è specificato SECLIST RESOURCE, le 
risorse vengono stampate in ordine alfabetico di ID utente. Se non viene speci- 
ficato alcun parametro, viene assunto USERID. 


CLASS specifica che devono essere stampate soltanto le entrate della riservatezza 
risorse dell'operatore che ha avviato la procedura. Se non viene specificato al- 
cun parametro, viene assunto USER. 


USER specifica che devono essere listate soltanto le entrate di riservatezza sulle 
risorse per l'operatore che esegue la procedura. Se non viene specificato 
alcun parametro, si presume USER. 


ALL specifica che devono essere listate tutte le entrate del file di riservatezza 
sulle risorse. Per usare questo parametro quando è attiva la riservatezza me- 
diante parola d'ordine l'operatore deve essere il responsabile principale della 
riservatezza o il responsabile della riservatezza. Se non è attiva la riservatezza 
mediante parola d’ordine, l'operatore deve eseguire la procedura dalla conso- 
le di sistema. 


Esempio 1 


Questo esempio mostra come il responsabile della riservatezza o il responsabile 
principale della riservatezza stamperebbero tutte le entrate del file di riservatezza 
sulle risorse in ordine alfabetico per nome di risorsa. 


SECLIST RESOURCE, ,RNAME,ALL 


Esempio 2 


Questo esempio mostra come il funzionario della riservatezza o il funzionario 
principale della riservatezza, stamperebbero le entrate del file ID degli utenti 
con le parole d'ordine degli utenti. 


SECLIST USERID,,PW 


PROCEDURA SECREST 


La procedura SECREST ripristina il file di identificazione dell'utente o il file 
di riservatezza sulle risorse con la copia che era stata salvata con la procedura 
SECSAVE, 


Se è attiva la riservatezza mediante parola d'ordine, soltanto il responsabile prin- 
cipale della riservatezza può eseguire la procedura SECREST. Se non è attiva la 
riservatezza mediante parola d'ordine, la procedura SECREST può essere eseguita 


soltanto dalla console di sistema. 


Per ulteriori informazioni su questi file e sulla riservatezza, vedere il manuale Pja- 
nificazione della Riservatezza. 


La procedura SECREST esegue il programma di utilità $PRURS o $RRSTR, a seconda 
dei parametri indicati. 


SECREST USERID ,nome file, [ampiezze | s |mnggaa |, j Il}, [ia volune | j 
RESOURCE © |&gmmaa Fl 
aammgg TI. 
T2 


si NOAUTO] ,|REWIND|,| NOUPDATE 
AUTO LEAVE UPDATE 
UNLOAD 





USERID specifica che si desidera ripristinare il file di identificazione degli utenti. 
Se non viene specificato alcun parametro, si presume USERID. 


RESOURCE specifica che si desidera ripristinare il file della riservatezza sulle ri- 
sorse. 


} nome file specifica il file su minidisco, su disco, su nastro o nastro a cassetta che 
contiene la copia salvata del file di identificazione dell'utente o del file risorse 
riservatezza. Questo file deve sostituire il file corrente. 


ampiezza specifica il numero massimo di record di cui tener conto nel file di 
identificazione degli utenti o nel file di riservatezza sulle risorse. Per il file di 
identificazione degii utenti, può trattarsi di qualsiasi numero da 18 a 3998. 
Per il file di riservatezza sulle risorse, può trattarsi di qualsiasi numero da 72 
a 63992. Se non viene specificato alcun numero, viene usato il numero mas- 
simo di record salvati nella copia. Se il numero immesso è troppo grande per 
il sistema o tropps piccolo per contenere tutti i record copiati, viene visualiz- 
Zato un messaggio di errore. 


mmggaa, ggmmaa o aammgg specifica la data di creazione del file su minidisco, 
| su disco, su nastro o nastro a cassetta che contiene la copia salvata. La data, 
se specificata, deve essere nel formato della data di sessione; usare il coman- 

do STATUS SESSION per determinare il formato della data di sessione. 


Se non è specificata alcuna data ed esiste più di un file su minidisco, su disco, 
| su nastro o nastro a cassetta, con il nome file specificato, viene usato il file 
più recente. 
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11 specifica che il file deve essere ripristinato da minidisco. Se non viene speci. 
ficato alcun parametro, sì presume 11. 


F1 specifica che il file deve essere ripristinato da un file su disco. 

T1,T20 TC specifica che il file deve essere ripristinato dal nastro. T1 indica che i 
il nastro è montato sull'unità nastro 1. T2 indica che il nastro è montato sull’u- 
nità nastro 2. TC indica che il nastro è un nastro a cassetta. i 


id volume specifica l'ID di volume del minidisco, nastro o nastro a cassetta che con- 
tiene la copia. Se viene specificato 11, T1, T2, o TC e non viene specificato 
alcun ID di volume, il SSP copia il file dal file su minidisco o nastro nella loca- 
zione specificata. 


S1, S2 o S3 specifica l'alimentatore di minidisco contenente il primo minidisco da 
elaborare. Questo parametro è consentito solo se è specificato 11. Se non è 
specificato alcun parametro si presume S1. 


Ml.nn o M2.nn specifica la locazione dei caricatore contenente il primo minidi- 
sco da elaborare. M1 indica il primo caricatore e M2 indica il secondo cari- 
catore. nn è un numero da 01 a 10 che identifica la locazione del minidisco 
nel caricatore. Specificare M1 equivale a specificare M1.01; specificare M2 
equivale a specifica M2.01. Questo parametro è consentito solo se è specifi- 
cato |1. : 


NOAUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, può essere usato soltanto l’alimentato- 
re specificato. Se occorrono altri minidischi, viene visualizzato un mes- 
saggio e l'operatore deve inserire il successivo minidisco nell’alimentato- 
re specificato. 


e Se viene specificato M1,nn o M2.nn, può essere usato soltanto il carica- 
tore specificato. L'elaborazione inizia con il minidisco nella locazione 
specificata e continua fino all'ultimo minidisco nel caricatore. Se sono 
necessari altri minidischi, viene visualizzato un messaggio e l'operatore 
deve inserire il successivo caricatore nell’alimentatore che viene usato. 
L'elaborazione riprende alla prima locazione nel caricatore. 


e Se è specificato T1 o T2, per tutti i volumi nastro verrà usata soltanto 
l'unità nastro specificata. 


e Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


Se non è specificato alcun parametro, si assume NOAUTO. 


AUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, è possibile usare tutti e tre i singoli 
alimentatori (S1, S2 e S3). L'elaborazione inizia con il minidisco nel- 
l'alimentatore specificato e continua fino al minidisco nell’alimentatore 
S3. Se occorrono altri minidischi, viene visualizzato un messaggio e 
l'operatore deve inserire i successivi minidischi. L'elaborazione riprende 


col minidisco nell’alimentatore S1. 


e Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli 
alimentatori di caricatore (M1 e M2). L'elaborazione inizia con il mini 
disco nella locazione specificata e continua fino al minidisco nella loca- 
zione M2.10. Se occorrono altri minidischi, viene visualizzato un mes- 
saggio e l'operatore quindi inserisce i successivi caricatori. L'elaborazione 


riprende alla locazione M1.01. 


e Se viene specificato T1 o T2, quando la bobina di nastro sull'unità na- 
stro originale è terminata, il sistema passerà all'altra unità nastro, se di- 
sponibile, per continuare l'elaborazione (da T1 a T2 o da T2 a T1). Se 
l’altra unità nastro non è disponibile, verrà usata quella originale. 


e Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l'unità nastro a cassetta. 


REWIND specifica che il nastro deve essere riavvolto all'inizio dopo che è stata 
eseguita la procedura SECREST. Si presume REWIND se questo parametro 
non viene specificato. 


LEAVE specifica che il nastro deve essere lasciato dove si trova una volta che è 
stata eseguita la procedura SECREST. L'operazione successiva su nastro inizia da 
questa posizione. 


UNLOAD specifica che il nastro deve essere riavvolto e scaricato dopo che è stata 
eseguita la procedura SECREST. Questo parametro non è consentito se è spe- 
cificato 11 o F1. Se sono specificati UNLOAD e TC, il nastro verrà riavvolto 
dopo l'elaborazione. 


NOUPDATE specifica che il campo ultima data parola d'ordine modificata dei profili 
utente con data zero deve essere impostato come la data corrente del siste- 
ma. Altri profili utente non vengono modificati. 


UPDATE specifica che il campo ultima data parola d'ordine modificata di tutti i pro- 
fili utente deve essere impostato come la data corrente del sistema. 


Esempio 1 


Questo esempio mostra come ripristinare il file di identificazione dell'utente da 
una copia su minidisco. L'ID di volume del minidisco è VOL001 e il minidisco è 
posto nell’alimentatore S1. Il nome del file su minidisco è USERFILE. 


SECREST USERID,USERFILE,,,I1,VOL001,,,, UPDATE 


Esempio 2 


Questo esempio mostra come ripristinare il file di identificazione dell'utente da 
una copia su nastro. L'ID di volume della bobina di nastro è VOLO01 ed il na- 
stro è montato sull'unità nastro 1. il nastro viene riavvolto e scaricato una volta 
che il file è stato ripristinato. 


SECREST USERID,USERFILE,,,T1,VOL001,,,UNLOAD,NOUPDATE 
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PROCEDURA SECSAVE 


La procedura SECSAVE salva su disco, su minidisco, su nastro o nastro a cassetta, 
il file di identificazione degli utenti o il file di riservatezza sulle risorse. Per ulteriori 
informazioni su questi file, vedere il manuale Pianificazione della Riservatezza. 


Se è attiva la riservatezza mediante parola d’ordine, soltanto il responsabile prin- 
cipale della riservatezza può eseguire la procedura SECSAVE. Se non è attiva la 
riservatezza mediante parola d'ordine, fa procedura SECSAVE può essere eseguita 


soltanto dalia console di sistema. 


La procedura SECSAVE esegue il programma di utilità $PRUSV. $RRSAV, a seconda 
dei parametri indicati in essa. 


USERID none file,|Il sia volume |, giorni di validità |, 
RESOURCE) Fl| — 
TI 


[re] 


Sl 
s2 
83 
Ml 
Me 


299 


s |NOAUTO| ,| REWIND 
AUTO LEAVE | 
UNLOAD 


+ nn 
»+nn 





USERID specifica che si desidera salvare il file di identificazione degli utenti. Se 
non viene specificato alcun parametro, si assume USERID. 


RESOURCE specifica che si vuole salvare il file di riservatezza sulle risorse, 
nome file specifica il file da creare. 


11 specifica che il file deve essere salvato su un minidisco. Se non è specificato 
alcun parametro, si presume 11. 


F1 specifica che il file deve essere copiato su un altro file su disco. 


T1,T2 0 TC specifica che il file’deve essere salvato su nastro. T1 indica che il na- 
stro è montato sull'unità nastro 1. T2 indica che il nastro è montato sull’unità 
nastro 2. TC indica che il nastro è un nastro a cassetta. 


id volume specifica l'ID volume del minidisco o della bobina nastro che deve riceve- 
re la copia salvata. Se viene specificato 11, T1, T2 o TC, deve essere specifi- 
cato un ID di volume. 


giorni di validità specifica per quanti giorni si deve conservare il file su minidisco, 
su nastro o nastro a cassetta. Può essere immesso qualsiasi numero decimale 
da 1 a 999. Se non viene specificato alcun parametro si presumono 999 gior- 
ni. Se è stato immesso o presunto 999, il file viene considerato un file perma- 
nente su minidisco. Vedere la Specifica OCL FILE (per i File su Minidisco) e la 
Specifica OCL FILE (per i File su Nastro) pet ulteriori informazioni sulla validità 
dei file su mindisco. 


S1, S2 o S3 specifica l'alimentatore per minidisco contenente il primo minidisco 
da elaborare. Questo parametro è consentito solo se è specificato 11. Se non 
è specificato alcun parametro si presume S1. 


M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidi- 
sco da elaborare. M1 indica il primo caricatore e M2 indica il secondo cari- 
catore. nn è un numero da 01 a 10 che identifica la locazione dei minidisco 
nel caricatore. Specificare M1 equivale a specificare M1.01; specificare M2 
equivale a specifica M2.01. Questo parametro è consentito solo se è specifi- 
cato [1. 


NOAUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, può essere usato soltanto l’alimentato- 
re specificato, Se occorrono altri minidischi, viene visualizzato un mes- 
saggio e l'operatore deve inserire il successivo minidisco nell'alimentato- 
re specificato. 


e Se viene specificato M1.nn o M2.nn, può. essere usato soltanto il carica 
tore specificato. L'elaborazione inizia con il minidisco nella locazione 
specificata e continua fino all'ultimo minidisco nel caricatore. Se sono 
necessari altri minidischi, viene visualizzato un messaggio e l'operatore 
deve inserire il successivo caricatore nell’alimentatore che viene usato. 
L'elaborazione riprende alla prima locazione nel caricatore. 


e Se viene specificato T1 o T2, per tutti i volumi nastro verrà usata soltan- 
to l'unità nastro specificata. 


e  Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


Se non è specificato alcun parametro, si assume NOAUTO. 


AUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, è possibile usare tutti e tre i singoli 
alimentatori (S1, S2 e S3). L'elaborazione inizia con il minidisco nel- 
nni l'alimentatore specificato e continua fino al minidisco nell'alimentatore 
S3. Se occorrono altri minidischi, viene visualizzato un messaggio e 
l'operatore deve inserire i successivi minidischi. L'elaborazione riprende 
col minidisco nell’alimentatore S1, 


e Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli 
alimentatori di caricatore (M1 e M2). L'elaborazione inizia con il mini- 
disco nella locazione specificata e continua fino al minidisco nella loca- 
zione M2.10. Se occorrono altri minidischi, viene visualizzato un mes- 
saggio e l'operatore quindi inserisce i successivi caricatori. L'elaborazione 
riprende alla locazione M1.01, 


‘e Se viene specificato T1 o T2, quando la bobina di nastro sull'unità na- 
stro originale è finita, il sistema passa all'altra unità nastro, se disponibi- 
fe, per continuare l'elaborazione (da T1 a T2 o da T2 a T1). Se l'altra 
unità nastro non è disponibile, viene usata l’unità nastro originale. 


e Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


REWIND specifica che il nastro deve essere riavvolto dopo che è stata eseguita 
la ‘procedura SECSAVE, Si presume REWIND se questo parametro non viene 
specificato. 


LEAVE specifica che il nastro deve essere lasciato dove si trova una volta che è 
stata eseguita la procedura SECSAVE. La successiva operazione su nastro inizia 
da questa posizione. 


UNLOAD specifica che il nastro deve essere riavvolto e scaricato dopo che è stata 


_ eseguita la procedura SECSAVE. Questo parametro non è consentito se è spe- 
si cificato 11 o F1. Se sono specificati UNLOAD e TC, il nastro verrà riavvolto 


dopo l'elaborazione. 


433 


434 


Esempio 1 


Questo esempio mostra come copiare su un minidisco il file di identificazione 
degli utenti. L'ID di volume del minidisco è VOL001 e il minidisco è posto nel- 
l'alimentatore di minidisco S1, ll nome del file su minidisco è USERFILE. 


SECSAVE ,USERFILE,,VOLOO1 


Esempio 2 


Questo esempio mostra come copiare su minidisco il file di riservatezza delle ri- 
sorse. L'ID di volume del minidisco è VOL001 e il minidisco è disposto nell’ali- 
mentatore di minidisco S1. Il nome del file su minidisco è RESFILE. 


SECSAVE RESOURCE,RESFILE,,VOLOOl 


Esempio 3 


Questo esempio mostra come copiare su nastro il file di identificazione dell'uten- 
te. L'ID di volume della bobina di nastro è VOL001 ed il nastro è montato sul- 
l'unità nastro 1. Ìl nastro è posizionato dove si ferma quando il file è stato co- 
piato. 


SFCSAVE ,USERFILE,T1,VOLOO1,,,,LEAVE 


FTA 


PROCEDURA SET 


La procedura SET crea le seguenti opzioni di ambiente dell'unità video: 
e Numero di righe stampate per pagina 

e Immagine della cinghia di stampa 

e Formato della data di sessione 

e Data di sessione 

e Ampiezza della regione assunta per difetto 

e Libreria assegnata all'unità video 

è Stampatrice per l'emissione stampata 

e Numero dei modulo 

e Stampatrice per l'emissione del tasto STAMPA 


è Necessità di creare un margine o un titolo con l'emissione del tasto STAMPA. 


Le opzioni specificate sono disposte nel record di configurazione dell'unità video, 
che definisce fe caratteristiche dell'unità video. Ciò fa sì che ie modifiche riman- 
gano in atto fino a che non ci si scollega. Queste informazioni rimangono inva- 
riate fino a che non viene eseguita un'altra procedura SET dall'unità video, non 
è ripristinata fa libreria di sistema oppure il sistema non viene di nuovo riconfi- 
gurato. 


Se viene eseguita la procedura SET durante una richiesta di interrogazione (l’ope- 
ratore ha premuto il tasto ATTEN), le modifiche rimangono in effetto soltanto 
durante la richiesta di interrogazione e non interessano il lavoro interrotto. Le 
informazioni visualizzate usando il comando STATUS non riflettono le modifi 
che effettuate durante la richiesta di interrogazione. 


La procedura SET non può essere eseguita dalla coda dei lavori o avviata dalla specifica 
OCL EVOKE. 


La procedura SET esegue il programma di utilità $SETCF. 


[rigne per pagina| ,[nenbro immagine |, MDY},|1megaa -[anpiezza 


DMY| |g&gnmaa 
YMD| jaammgg 


#LIBRARY SYS 


o, 


nome libreria|,jid dai a modulo |, 


[ia stampatrice tasto stanpe| s| BORDER »s | HEADER 


NOBORDER NOHEADER 


regi one] 5 
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righe per pagina specifica il numero di righe da stamparsi per pagina, ll numero 
massimo di righe che può essere specificato è 112; il valore minimo è 1. 


Per informazioni sui modo in cui il valore specificato determina il numero di 
righe stampate effettivamente per pagina, vedere la Specifica OCL FORMS. 


membro immagine specifica il nome del membro origine che contiene i caratteri 
della cinghia di stampa per la stampatrice a righe, Il SSP comprende i seguen- 
ti membri di cinghia di stampa: 


Nome membro 


BELTA48 
BELT48NH 
BELT64B 
BELT64C 
BELT96 
BELT188B 


Per informazioni sui caratteri disponibili in queste cinghie di stampa, vedere 
Cinghie di stampa 3262. lì nome membro della cinghia di stampa è anche 
detto memoria di transito della serie di caratteri universali (UCSB) nell'/BM 
3262 Printer Models A1 e BI Component Description and Operator’s Guide, 
GA33-1530. 


MDY specifica che il formato della data di sessione è mese-giorno-anno. 
DMY specifica che il formato della data di sessione è giorno-mese-anno. 
YMD specifica che il formato della data di sessione è anno-mese-giorno. 


mmggaa, ggmmaa o aammgg specifica la data di sessione. La data deve essere in- 
dicata nel formato della data di sessione. 


ampiezza regione specifica la dimensione della regione da usare per i programmi 
eseguiti da questa unità video, a meno che non sia elaborata una specifica 
OCL REGION come parte di. un lavoro. La dimensione è specificata in 
K-byte (1 K-byte contiene 1024 byte). 


nome libreria specifica la libreria di collegamento da assegnarsi all'unità video. 
E’ possibile assegnare la libreria di sistema (FEIBRART: Se viene specifica- 
to 0 non è attiva alcuna libreria, 


La libreria specificata non diventa attiva fino alla successiva volta in cui l'o- 
peratore si collega all'unità video. 


id stampatrice o SYSTEM specifica la stampatrice di collegamento assunta per difetto 
da usare per le informazioni di emissione create dall'unità video. 


L'emissione stampata della lista di sistema per l'unità video verrà stampata 
sulla stampatrice precedentemente assegnata fino al prossimo collegamento 
dell'operatore all'unità video. E’ possibile usare la procedura PRINT o SYS- 
LIST per modificare immediatamente la stampatrice usata per l'emissione di 
lista di sistema. Vedere la Procedura PRINT o \a Procedura SYSLIST per 
informazioni sull'esecuzione di queste procedure, 


id stampatrice specifica l'ID a due caratteri della stampatrice da usare come 
stampatrice di collegamento per l’unità video. 


SYSTEM o SYS specifica che la stampatrice di sistema deve essere usata come 
stampatrice di collegamento per l’unità video. 


numero modulo specifica il numero dei moduli da usare per l'emissione dell'unità 
video. ll numero dei moduli può anche essere modificato: 


e Da una specifica FORMS 
e Dauna specifica PRINTER (solo per quel passo di stampa) 
e Dalla procedura PRINT. 


id stampatrice tasto STAMPA specifica l'ID a 2 caratteri del terminale della stam- 
patrice da usare per l'emissione del tasto STAMPA. 


BORDER specifica che deve essere stampato un margine indicante le posizioni 
dello schermo intorno all'emissione del tasto STAMPA. Vedere ia Procedura 
PRINTKEY per un esempio del margine che viene stampato. 


NOBORDER specifica che non deve essere stampato alcun margine intorno all’e- 
missione del tasto STAMPA. 


HEADER specifica che deve essere stampato al disopra dell'emissione del tasto 
STAMPA un titolo indicante da dove è stato premuto il tasto STAMPA. Ve- 
dere la Procedura PRINTKEY per un esempio del titolo che viene stampato. 


NOHEADER specifica che non deve essere stampato alcun titolo al di sopra del- 
l'emissione del tasto STAMPA. 


Esempio 1 


Modificare il numero di righe per pagina a 66. 


SET 66 


Esempio 2 


Modificare la dimensione della regione da usare per i programmi eseguiti da que- 
sta unità video. 


SET 333,18 
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PROCEDURA SETCOMM 


La procedura SETCOMM consente di impostare talune opzioni di comunicazione 
nel record di configurazione di comunicazione del sistema. E’ possibile usare il 
comando di controllo STATUS COMCNFIG per visualizzare le impostazioni at- 
tuali. Per maggiori informazioni sulla procedura SETCOMM, vedere il manuale Using 
System/36 Communications. 


Le modifiche che si effettuano usando la procedura SETCOMM rimangono in ef- 
fetto fino a che non sono cambiate da una successiva procedura SETCOMM. 


Dopo aver eseguito la procedura SETCOMM, occorre eseguire l’IPL del sistema. 
Ciò fa sì che le modifiche apportate diventino effettive. Vedere il manuale Ope- 
rating Your Computer per informazioni sul modo in cui eseguire l'IPL. Qualsiasi 
valore impostato per un terminale video dalla procedura ALTERCOM andrà perso 
ed andranno in vigore i nuovi valori specificati nella procedura SETCOMM. Do- 
po l’IPL, usare il comando STATUS COMCNFIG per assicurarsi che le modifiche 
siano corrette. 


La procedura SETCOMM esegue il programma di utilità $SETCP. 


SETCOMM numero linea | , | NONSWTCH |, {CLOCK , INRZIJ, |[CONCAR , | TONE 
1 SWITCHED NOCLOCK NRZ NOCONCAR NOTONE 
MULTTRIB 
MULTCONT 
SHM 


SEP , |EON i [var tempo scadenza ste | [numero tentativi ripetuti se | 3 


NOSEP NOEON 


IBM386X |,|X25 , | 2400 BPS 
IBM387X NOX25 4800 BPS 
NONIBM 9600 BPS 
IBMLPDA 56K BPS 





Quantunque ciascun parametro sia facoltativo, se ne deve specificare almeno uno. 
Se non viene specificato un parametro, i valori prefissati rimangono invariati. 


numero linea specifica il numero della linea di comunicazione per la quale devo- 
no essere modificate le regolazioni. Se non viene specificato alcun parametro, si 
presume 1. 

NONSWTCH specifica che si tratta di una linea punto a punto, non commutata. 


SWITCHED specifica che si tratta di una linea punto a punto commutata. 


MULTTRIB specifica che il Sistema/36 è una stazione tributaria a derivazione 
multipla, Questo parametro non può essere usato con SDLC. 
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MULTICONT specifica che il Sistema/36 è una stazione di controllo a derivazio- 
ne multipla, Guesto parametro non può essere usato con BSC, 


SHM specifica che la linea utilizza la X.21 SHM (in modo scollegamento se non at- 
tiva), che riduce l'utilizzo della linea scollegandola quando non vi è attività su 
di essa. 


Per maggiori informazioni vedere la procedura DEFINX21. Per maggiori detta- 
gli vedere il manuale Using System/36 Communications. 


CLOCK specifica che il sistema deve fornire tempificazione di macchina per la 
comunicazione dati. 


NOCLOCK specifica che il modem o un'altra fonte esterna ha il dispositivo di 
tempificazione. 


NRZI specifica la codifica dati NRZ! quando il sistema sta usando il protocollo 


SDLC per i modem che sono sensibili a taluni profili di bit nel flusso di dati. 
NRZI può essere usato soltanto se il modem del Sistema/36, il modem del 
sistema remoto e il sistema o l’unità remota stanno a loro voita usando 
NRZI. 


NONRZI specifica che la linea è non-NRZI. 


CONCAR specifica una portante continua. Si tratta di un dispositivo che mantie- 
ne attivo il segnale ‘’richiesta di trasmettere’’. Specificare CONCAR quando 
vengono usati i modem o i modem eliminators e la stazione di controllo mul- 
tipunti su una linea di comunicazione non commutata a quattro fili o quan- 
do l'interfaccia è una linea di comunicazioni a quattro fili non commutata, 
da punto a punto ed il modem non supporta la rete commutata di riseva. 
Specificare inoltre CONCAR se viene usata una rete X.25. 


NOCONCAR specifica che il dispositivo di portante continua non sarà usato. 
Specificare NOCONCAR per una stazione tributaria multipunto, per reti 
da punto a punto a due fili, per una linea telefonica pubblica commutata o 
per un'interfaccia che usa un Adattatore Servizi Dati Digitali (DDSA) o usa 
un adattatore di interfaccia X.21 su una rete commutata. 


TONE specifica che è richiesto un tono di risposta diverso da quello degli Stati 
Uniti per la risposta manuale e per le comunicazioni a risposta automatica. 
Questa regolazione dipende dal modem. 


NOTONE specifica che non è richiesto un tono di risposta non-Stati Uniti. 


SEP specifica che l’unità di chiamata automatica supporta caratteri separatori. 
Quando il sistema tenta di selezionare un numero telefonico contenente un 
Carattere separatore, il carattere viene inviato all'unità di chiamata automati 
ca per eseguire il ritardo di separazione. 


Vedere la Procedura DEFINEPN per una descrizione dell'uso dei caratteri se- 
paratori. 


NOSEP specifica che l'unità di chiamata automatica non supporta i caratteri sepa- 
ratori. Quando il sistema tenta di formare un numero telefonico contenente 
un carattere separatore, il carattere non viene inviato all'unità di chiamata 
automatica. Per contro, il sistema effettua un ritardo di separazione di 3 se- 
condi. 
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EON specifica che l'unità di chiamata automatica non ha ia capacità di rilevamen- 
to del tono di risposta. Se l’unità di chiamata automatica non ha questa ca- 
pacità, occorre usare un carattere di fine numero nei numeri telefonici speci- 
ficati con la procedura DEFINEPN. Il carattere di fine numero viene inviato 
dal sistema all'unità di chiamata automatica. 


Vedere la Procedura DEFINEPN per una descrizione dell'uso dei caratteri se- 
paratori. 


NOEON specifica che l’unità di chiamata automatica ha ia capacità di rilevamen- 
to del tono di risposta. Se si usa il carattere di fine numero nei numeri tele- 
fonici specificati con la procedura DEFINEPN il carattere non verrà trasmes- 
so dal sistema all'unità di chiamata automatica. 


valore tempo scadenza sdic specifica a incrementi di mezzo secondo, il valore di 
tempo scadenza SDLC. E’ possibile immettere qualsiasi numero da 05 a 80, 
dove la prima cifra indica i secondi e la seconda cifra rappresenza i mezzi 
secondi e deve essere O o S. Per esempio 25 indica due secondi e mezzo, 30 tre 
secondi. 


num. tentativi ripetuti sdic specifica il numero di tentativi di errore SDLC prima- 
rio da effettuare. E’ possibile immettere qualsiasi valore da 1 a 5. Tale valore 


moltiplicato per 7 è il numero di tentativi che devono essere effettuati, 


IBM386X specifica che sulla linea di comunicazione viene usato un modem ester- 
no 3863, 3864 o 3865. 


IBM387X specifica che sulla linea di comunicazione viene usato un modem ester- 


no IBM 3872, 3874 o 3875. 
NONIBM specifica che viene usato un modem non-1BM. 


IBMLPDA specifica che sulla linea di comunicazione viene usato un modem esterno 
IBM con funzioni LPDA (Link Problem Determination Aid). 


X25 specifica che la linea usa ‘il supporto X.25. Questo parametro è valido soltanto 
per ELCA. 


NOX25 specifica che la linea non usa il supporto X.25. Questo parametro è valido 
soltanto per ELCA. 


2400BPS specifica una linea DDSA (Adattatore Servizi Dati Digitali) con una velocità di 
trasmissione di 2400 bps. Questo parametro è valido soltanto per ELCA. 


4800BPS specifica una linea DDSA con una velocità di trasmissione di 4800 bps. 
Questo parametro è valido soltanto per ELCA. 


9600BPS specifica una linea DDSA con una velocità di trasmissione di 9600 bps. 
Questo parametro è valido soltanto per ELCA. 


56KBPS specifica una linea DDSA con una velocità di trasmissione di 56000 bps. 
Questo parametro è valido soltanto per ELCA. 


Esempio 


Per impostare la linea di comunicazione 1 come linea non commutata punto a 
punto. 


SETCOMM ,NONSWITCH 


PROCEDURA SEU 


La procedura SEU avvia il programma di utilità immissione dati origine (SEU). E' 
possibile usare it SEU per creare o modificare programmi, procedure, membri di 
messaggi, menù o tracciati video. 


I{ SEU fa parte del programma di utilità su licenza. Per ulteriori informazioni sul 
modo in cui usare il SEU, vedere il manuale Programma di utilità per l'immissione 
di dati origine (SEU). Per informazioni sulla visualizzazione di tracciati e menù, 
vedere il manuale Guida alla definizione dei tracciati video, Per ulteriori informa- 
zioni sui membri di messaggi, vedere la Procedura CREATE. 


(8) ASEQXTRA 


nome membro, |SOURCE |, |membro formati dia specifica |, 
PROC 


) 


(CP 
A 
Fo. 
R 
T 
W 


nome Libreria s [rile origine analizzato | 
libreria corrente 








Se non vengono specificati ì parametri, il SEU mostra lo schermo che consente 
di immettere i parametri stessi. 


nome membro specifica il membro origine o di procedura che si desidera creare 
o modificare. Un nome membro può avere fino a 8 caratteri e deve iniziare 
con un carattere alfabetico (da A a Z, #, $ o @). I rimanenti caratteri pos- 
sono essere qualsiasi combinazione di caratteri (numerici, alfabetici e specia- 
li). Occorre evitare di usare i seguenti caratteri in quanto hanno speciali signi- 
ficati nelle procedure: virgole (,), apici (’), spazi in bianco, punti di domanda 
{?), barrette (/), segni di maggiore {>} e segni di uguale (=). Non usare DIR, 
LIBRARY o ALL come nome di membro. 


SOURCE o S specifica un membro origine di libreria. Se non viene specificato 
alcun parametro, si presume SOURCE o S. 


PROC o P specifica un membro di procedura di libreria. 


A specifica un programma RPG Il che contiene specifiche di auto report. La 
sintassi del programma RPG ll è controllata dal SEU, {Il SEU visualizza la 
specifica RPG per ciascuna specifica nel membro origine, 


F. specifica un membro origine di libreria che contiene specifiche di tracciati 
video S e D. Il SEU visualizza le specifiche di formato per ciascuna specifica 
nel membro origine. 


R specifica un membro origine di libreria che contiene un programma RPG Il. 


La sintassi del programma RPG Il è controllata dal SEU. ll SEU visualizza 
la specifica RPG per ciascuna specifica nel membro origine. 
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T 


W 


specifica un membro origine di conversione messaggi. 


specifica un membro origine contenente specifiche WSU. II SEU visualizza 
la specifica WSU per ciascuna specifica nel membro origine. 


membro formati seu specifica il nome del membro tracciati video SEU da usa- 


re per preparare per l'emissione le specifiche origine. Se non viene specificato 
alcun nome di formato, si presume #SE@XTRA. 


lunghezza specifica specifica la lunghezza per ciascuna specifica origine o di pro- 


cedura. Può trattarsi di qualsiasi numero decimale da 40 a 120. Se il membro 
esiste, si presume la lunghezza della specifica del membro. Se il membro vie- 
ne creato, i valori che è possibile specificare e i valori che sono assunti dal 
SEU se non viene indicata una lunghezza di specifica, sono i seguenti: 


Lunghezza specifica Lunghezza specifica 
Tipo membro ammessa ammessa 


SOURCE, S da 40 a 120 
da 40 a 120 
da 80 a 96 
da 40 a 120 
da 80 a 96 
da 40 a 120 
da 40 a 120 























nome libreria specifica la libreria che conterrà il membro di libreria che viene mo- 


dificato o creato. Se non viene specificato alcun membro di libreria, si presu- 
me la libreria corrente. 


file origine analizzato: questo parametro è usato dalle procedure RPGONL, CO- 


Esempio 


BOLONL e FORTONL per consentire la correzione dei membri origine ana- 
lizzati. Quando si avvia il SEU, non occorre specificare questo parametro. 


Questo parametro specifica il nome di un file su disco che contiene specifi- 
che origine e messaggi diagnostici. Il file deve essere stato creato da un com- 
pilatore, ad esempio la procedura RPGC. Se viene specificato un file origine 
analizzato, il SEU usa quel file come immissione e consente di effettuare mo- 
difiche. Quando il SEU termina, il file unitamente a tutte le modifiche ap- 
portate, sostituisce il membro origine specificato nel primo parametro. 


Vedere il manuale di programmazione per ulteriori informazioni sui membri 
origine analizzati. 


Questo esempio mostra come avviare il SEU per creare o modificare una proce- 
dura denominata PAYROLL. La procedura è contenuta nella libreria corrente. 


SEU PAYROLL,P 


Zan 


PROCEDURA SEULOAD 


La procedura SEULOAD crea una libreria denominata #SEULIB e copia il sup- 
porto SEU dal minidisco in quella libreria. SEULOAD copia ulteriore supporto 
nella libreria di sistema (#LIBRARY). La procedura SEULOAD può copiare mi- 
nidischi PID (Program Information Department) o minidischi creati dalla proce- 
dura SEUSAVE. Vedere la Procedura SAVE sul modo in cui salvare il supporto 
SEU su minidisco. 


La procedura SEULOAD potrebbe modificare il record di configurazione princi- 
pale con il risultato che potrebbe non esserci un corrispondente membro di con- 
figurazione. Per modificare il membro di configurazione per farlo corrispondere 
al record di configurazione principale, vedere il manuale Modifica della configu- 
razione del sistema. Si dovrebbe normalmente usare la procedura CNFIGSSP 
per aggiungere supporto al sistema. E’ possibile usare la procedura SEULOAD 
per ripristinare il supporto che era stato precedentemente aggiunto. 


Se il SEU non è in uso corrente sul sistema, è necessario utilizzare la procedura TO- 
LIBR per copiare il file SEU su minidisco nella libreria # LIBRARY prima di eseguire 
SEULOAD. Se # LIBRARY con il SEU era stato salvato e poi ripristinato prima del- 
l'esecuzione di SEULOAD, non è necessario copiare il file minidisco SEU con la pro- 
cedura TOLIBR. 


SEULOAD |Al|j Sl 
A2||s2 


A3} | S3 
al Ml.nn 


M2.nn 





A1, A2, A3 o AA indica la preferenza del disco; cioè l'unità disco che viene esa- 
minata per prima alla ricerca di spazio disponibile. Se non è disponibile spa- 
zio a sufficienza su quell’'unità, vengono esaminate altre unità (se esistono) 
e #SEULIB viene inserito sull'unità disco meno usata. Se non è specificata 
alcuna locazione ed il sistema ha più di un'unità disco, #SEULIB viene 
inserito sull'unità disco meno usata. 


A1 specifica che # SEULIB deve essere inserita sul primo disco, se è disponibile 
spazio. 


A2 specifica che #SEULIB deve essere inserito sul secondo disco, se è disponibile 
spazio. 


A3 specifica che #SEULIB deve essere inserito sul terzo disco, se è disponibile 
spazio. 


A4 specifica che #SEULIB deve essere inserito sul quarto disco, se è disponibile 
spazio. 


S1, S2 o $3 specifica l'alimentatore di minidischi contenente il primo minidisco 
da usare. Se non è specificata alcuna posizione di minidisco, si presume -S1. 
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M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidi- 
sco da elaborare, M1 indica il primo caricatore e M2 indica il secondo cari- 
catore. nn è un numero da 01 a 10 che identifica la locazione del minidisco 
nel caricatore. Specificare M1 equivale a specificare M1.01; specificare M2 
equivale a specifica M2.01. ; 


YoN specifica se i membri origine tracciato video per +SE@FORM e # SE@ XTRA 


devono essere caricati. Se non viene specificato alcun parametro, viene richie- 
sto il valore. Se su richiesta si specifica qualsiasi cosa diversa da N, i membri 


origine vengono caricati. 


Y specifica che i membri origine devono essere caricati. 


N specifica che i membri origine non devono essere caricati. 


Esempio 
Creazione di #SEULIB su disco e copia del supporto SEU da minidisco, 


SEULOAD 


PROCEDURA SEUSAVE 
La procedura SEUSAVE copia su minidisco il supporto SEU. Il supporto SEU 
viene copiato dalie librerie #SEULIB e #LIBRARY. E’ possibile usare la Proce- 
dura SEULOAD per caricare il supporto SEU da un minidisco di riserva. Il minidisco de- 
stinato a contenere la copia salvata deve avere come ID di volume PPUTIL e deve essere 
disposto nell’alimentatore S1. 


SEUSAVE 


La procedura SEUSAVE non ha parametri. 
Esempio 


Copia del supporto SEU su minidisco. 


SEUSAVE 
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PROCEDURA SLIB 


La procedura SLIB specifica il nome della libreria per la sessione dell’unità video. 
La libreria di sessione e la libreria corrente sono identiche quando si immettono 
procedure o comandi di controllo dalia tastiera. E’ possibile modificare la libreria 
corrente per una procedura usando la specifica OCL LIBRARY. Vedere Specifica 
OCL LIBRARY per ulteriori informazioni. 


La libreria corrente è la prima in cui il SSP cerca le procedure, i programmi, i 
menù, i tracciati video e i membri di messaggi. Se il SSP non trova il membro 
nella libreria corrente, SSP cerca quindi nella libreria di sistema. 


Una libreria rimane la libreria di sessione fino a che non si scollega il sistema op- 
pure: 


e Non viene immessa un'altra procedura SLIB. 


e Non viene elaborato o immessa la specifica OCL MENU o un comando con 
un parametro di libreria. 


e Non viene immessa una specifica OCL LIBRARY. 


e in una procedura non viene elaborata una specifica OCL LIBRARY con SES- 
SION-YES. 


Una volta che è specificata una libreria di sessione, quella libreria rimane allocata 
all'unità video fino a che non è specificata una diversa libreria o la libreria di 
sistema. Se viene specificata una libreria diversa mentre l’unità video sta ancora 
usando uno o più membri dalla libreria di sessione precedenti (ad esempio sta 
usando un menù da quella libreria), la libreria dì sessione precedente rimane allo- 
cata all'unità video fino a che l’unità video non usa più i membri da quella libre- 
ria. Di conseguenza sulla libreria non possono essere eseguite talune funzioni, ad 
esempio la procedura CONDENSE, quantunque non sia più la libreria di sessione 
sull'unità video, 


Quando un programma nell’ambito di una procedura viene interrotto, durante la 
richiesta di interrogazione viene usata la libreria di sessione. La libreria corrente 
della procedura interrotta sarà di nuovo quella corrente quando la procedura 
viene ripresa. Per esempio, la libreria di sessione è denominata MYLIB e una pro- 
cedura contiene la seguente specifica: 


// LIBRARY NAME-JOBLIB 


Se un programma nell’ambito della procedura viene interrotto, la libreria di ses- 
sione (MYLIB e non JOBLIB) viene usata durante la richiesta d’interrogazione. 
Per informazioni sull'interruzione di un programma, vedere il manuale Guida 
Operativa. 
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Se viene immessa la procedura SLIB da uno schermo di MENU, una o più delle 
opzioni sul menù visualizzato potrebbero non essere corrette in quanto le proce- 
dure corrispondenti a quelle opzioni non esistono nella nuova libreria di sessione, 
Pertanto, non si deve cambiare libreria senza cambiare il menù, Per rimuovere un 
menù dallo schermo, immettere l'opzione 0 (zero). 


La procedura SLIB elabora una specifica OCL LIBRARY in cui è specificato 
SESSION-YES. Per ulteriori informazioni vedere la Specifica OCL LIBRARY, 


La procedura SL.IB elabora una specifica OCL LIBRARY. 


nome libreria 
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nome libreria specifica la libreria che sarà la libreria di sessione. Deve essere spe- 
cificato un nome di libreria. 


Esempio 


La seguente procedura specifica che una libreria denominato MYLIB è la libreria 
di sessione. i 


SLIB MYLIB 


PROCEDURA SMF 
Il programma di supporto per rilevare le prestazioni del sistema (SMF) consente 
di registrare e stampare informazioni sul modo in cui il sistema viene usato. La 
procedura SMF visualizza un menù che consente di selezionare la funzione SMF 
che si vuole eseguire. Le opzioni sul menù, sono: 
e Avviamento del programma di raccolta dati SMF {la procedura SMFSTART). 
e interruzione del programma di raccolta dati SMF (la procedura SMFSTOP). 
e Stampa dei dati analizzati e raccolti (la procedura SMFPRINT). 


e Stampa di emissione da SMF su file su disco {la procedura SMFDATA). 


Per ulteriori informazioni sul SMF, vedere il manuale SMF Guide. 


SMF 


La procedura SMF non ha parametri. 
Esempio 


Questo esempio mostra come visualizzare il menù SMF. 


SMF 
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PROCEDURA SMFDATA 


La procedura SMFDATA scrive l'emissione da un prospetto SMF su un file su 
disco, che può essere usato come immissione per l’analisi da parte di programmi 


applicativi. 


Per ulteriori informazioni sulla procedura SMFDATA, vedere il manuale SMF 
Guide, 


SMFDATA |DETAIL |,|cancell. dopo creazione file|,|nome file], 
SUMMARY| |N SMF. LOG 


ALL: | lx 


SMF. DATA 


ba prospetto = è [ata inizio] 5 fora inizio] s [ora fine | 





ALL DETAIL o SUMMARY specificano il tipo di file da creare con la procedura SMFDATA. 
Se non viene specificato alcun parametro, si presume ALL. La Figura 24 mostra 
i tipi di informazione che sono contenuti in ciascun file. 
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Cai 










File Prospetto ALL File Prospetto SUMMARY File prospetto DETAIL 
Informazioni di configurazione IPL Informazioni di configurazione IPL Informazioni di configurazione IPL 


Dati di configurazione di Dati di configurazione di 
comunicazioni se attivi e selezionati comunicazioni se attivi e selezionati 


e Statistiche per ciascun intervallo 

campione: 

— Frequenza uso unità 

— Uso area di lavoro delie 
attività 

— Utilizzo di CACHE su disco 

— Stato delle attività 

— Informazioni I/E e SEC 
dall'attività se selezionata 

— Dati attività terminate 

— Contatori accessi e file 
utenti 

— Contatori accessi e file di 
sistema 

— Totali di memoria 

— Contatori di eventi di 
sistema (SEC) 

— Contatori di 1/E 

- » Uso del dispositivo di 

. memoria dati (DSA) 

— Uso della linea di 
comunicazioni se attiva 
e selezionata 


Dati di riepilogo Dati di riepilogo Dati di riepilogo 


Figura 24. Opzioni per i file dei prospetti SMF 



















e Statistiche per ciascun intervallo 
campione: 





Frequenze uso unità 

— Uso area di lavoro delle 
attività 

— Utilizzo di CACHE su disco 

— Stato delle attività 

— Totali di memoria 
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Cancellazione dopo creazione file specifica se il file di raccolta dati SMF deve 
essere rimosso dal disco al termine della procedura SMFDATA. 


N specifica che il file non deve essere cancellato. Se non viene specificato alcun 
Carattere, si presume N. 


Y specifica che il file deve essere cancellato, 


nome file raccolta dati specifica il nome del file di raccolta dati da usare come 
immissione per la procedura SMFDATA. Se non è specificato alcun nome, 
si presume SMF.LOG. 


nome file prospetto specifica il nome desiderato per il file di prospetto che con- 
terrà i dati dal file di raccolta dati. Se non è specificato alcun nome, si pre- 
sume SMF.DATA, 


data inizio specifica la data di inizio per l'uso dei dati SMF., Solo i dati raccolti 
dopo la data specificata sono inclusi nel file di prospetto. La data deve es- 
sere specificata con sei cifre decimali nella forma aammgg dove: 


aa specifica l'anno e può essere qualsiasi numero da 00 a 99. 
mm specifica il mese e può essere qualsiasi numero da 00 a 12. 
gg specifica il giorno e può essere qualsiasi numero da 00 a 31. 
ora inizio specifica un'ora di inizio per l'uso dei dati SMF. Nel file di prospetto 
sono inclusi soltanto i dati raccolti dopo l'ora di inizio specificata. L'ora de- 
ve essere specificata con 6 cifre decimali nella forma hhmmss dove: 
hh specifica le ore e può essere qualsiasi numero da 00 a 23. 
mm specifica i minuti e può essere qualsiasi numero da 00 a 59. 


ss specifica i secondi e può essere qualsiasi numero da 00 a 59. 


L'ora può essere compresa fra 000001 e 235959. Se non è specificata l'ora, 
il file di prospetto dovrebbe iniziare con il primo elemento di dati raccolto 
da SMF, 


ora fine specifica il tempo finale per i dati SMF. Nel file di prospetto sono in- 
clusi soltanto i dati che precedono l’ora finale specificata. L'ora deve essere 
specificata con 6 cifre decimali nel formato hhmmss e può essere compresa 
fra 000001 e 235959, Se non è specificata alcuna ora o se è specificato 
000000, il file di prospetto dovrebbe interrompersi con l’ultimo elemento 
di dati raccolto da SMF. 


Esempio 


Questo esempio mostra come creare un file di prospetto denominato SMF.DATA 
dal file di raccolta dati denominato SMF.LOG. Il file di prospetto dovrebbe con- 
tenere dati riepilogativi. 


SMFDATA SUMMARY 


ai 


SMFPRINT 


PROCEDURA SMFPRINT 


La procedura SMFPRINT lista un prospetto prestabilito dei dati raccolti dal pro- 
gramma di raccolta dati del programma di supporto per rilevare le prestazioni 
de! sistema (SMF). Per ulteriori informazioni su SMF, vedere il manuale SMF 
Guide, 


DETAIL |,|rimozione dopo stampa |, | SYSTEM ,inome fil 
SUMMARY| N id stampatrice| |SMF.LOG 
ALL Y LL 


[ora inizio] [ora tine] 2 [ate inizio] 


i: 
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DETAIL, SUMMARY, ALL o MINI specifica il tipo di lista creata dalla procedura SMFPRINT. 
Se non viene specificato alcun parametro, si presume DETAIL. La Figura 25 mostra 
le informazioni listate per ciascun tipo. ' 









DETAIL (Assunto per SUMMARY ALL 


difetto) 












Informazioni di configu- 
razione 


Informazioni di configu- 
razione 


Informazioni di configu- 
razione 


Informazioni di configu- 
razione 
























Dati d'informazioni di 
configurazione delle co- 
municazioni se attivi e 

selezionati 


Dati d'informazioni di 
configurazione delle co- 
municazioni se attivi e 

selezionati 


Dati informazioni di con- 
figurazione delle comuni- 
cazioni se attivi e selezio- 
nati 













































Le seguenti informazioni 
su ciascun intervallo 
campione: 


Le seguenti informazioni 
su ciascun intervallo 
campione: 


Le seguenti informazioni 
su ciascun intervallo 
campione: 









eFrequenze uso unità 

eUso area di lavoro 
delle attività 

eUtilizzo di CACHE su 
disco 

® Stato delle attività 

e Informazioni I/E e SEC 
dall'attività se selezionata 

® Dati attività terminate 

e Contatori accessi e file 
utenti 

® Contatori accessi e file di 
sistema 

e Totali di memoria 

e Contatori di eventi di 
sistema (SEC) 

e Contatori di I/E 

@ Uso del dispositivo di 
memoria dati (DSA)} 

® Uso della linea di 
comunicazioni se attiva 
e selezionata 


Dati di riepilogo Dati di riepilogo Dati di riepilogo IL ii 


Figura 25. Lista di opzioni per SMFPRINT 


® Frequenza uso unità 
e Eventi significativi e 
contatori di I/E 


® Frequenza uso unità 

@ Uso area di lavoro delle 
attività 

eUtilizzo di CACHE su 
disco 

e Stato delle attività 

eTotali di memoria 
























rimozione dopo stampa specifica se il file di raccolta dati SMF deve essere rimos- 
so dopo le stampe dei dati. E’ possibile specificare Y o N. 


N specifica di non cancellare il file. Se non viene specificato alcun parame- 
tro, si presume N. 


Y specifica di cancellare il file. 


SYSTEM specifica che deve essere usata la stampatrice di sistema per stampare 
l'emissione. Se non viene specificato alcun parametro, si presume SYSTEM. 


id stampatrice specifica l'ID di terminale della stampatrice sulla quale deve essere 
stampata l'emissione. E’ possibile usare il comando STATUS WORKSTN per 


determinare l'ID di stampatrice. 


nome file specifica il file su disco SMF che contiene i dati da listare. Se non vie- 
ne specificato alcun nome si presume il nome SMF.LOG. 
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CT 


Pesa. 


2 


nome file specifica il file su disco SMF che contiene i dati da listare, Se non vie- 


ne specificato alcun nome si presume îl nome SMF.LOG. 


data inizio specifica la data di inizio per l'uso dei dati SMF. Solo i dati raccolti 


ora 


ora 


Esempio 


dopo la data specificata sono inclusi nel file di prospetto. La data deve es- 
sere specificata con sei cifre decimali nella forma aammgg dove: 


aa specifica l’anno e può essere qualsiasi numero da 00 a 99. 
mm specifica il mese e può essere qualsiasi numero da 00 a 12. 
gg specifica il giorno e può essere qualsiasi numero da 00 a 31. 


inizio specifica l'ora di inizio per l’impiego dei dati SMF. Nella lista vengono 
inclusi soltanto i dati raccolti dopo l’ora di inizio specificata. L'ora deve esse- 
re specificata con 6 cifre decimali nel formato hhmmss (ore-minuti-secondi), 


dove: 


hh specifica le ore e può essere qualsiasi numero da 00 a 23. 
mm specifica i minuti e può essere qualsiasi numero da 00 a 59. 
ss specifica i secondo e può essere qualsiasi numero da 00 a 59. 


L'ora può andare quindi da 000001 a 235959. Se non è specificata l'ora, o 
se è specificato 000000, la lista dovrebbe iniziare con il primo elemento di 
dati raccolto dal SMF. 


fine specifica i'ora finale per i dati SMF. Solo i dati che precedono l’ora fina- 
le specificata, sono compresi nella lista. L'ora deve essere specificata sotto 
forma di 6 cifre decimali nel formato hhmmss. L'ora.può andare da 000001 
à 235959. Se non è specificata l'ora o se è specificato 000000 la lista deve 
interrompersi con l'ultimo elemento di dati raccolto dal SMF. 


Questo esempio mostra come stampare i file di raccolta dati SMF.LOG. Deve es- 


sere 


stampata una lista di riepilogo. 


SMFPRINT SUMMARY 
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PROCEDURA SMFSTART 


La procedura SMFSTART avvia il programma di raccolta dati del programma di 
supporto per rilevare le prestazioni del sistema (SMF). Per ulteriori informazioni 
su SMF, vedere il manuale SMF Guide. 


intervallo di tempo|,|ampiezza file|,,|dati delle comunicazioni), 
100 200 N 


nome file s|velocità linea 1] ,|verocità linea 2|,|verocità linea 3| , 
SMF. LOG 


[velocità linea x], dati di immiss/emiss e ulteriori 
N 


L 


[velocità linea 5] , [velocità linea 6] , [velocità linea Fl; 


[velocità linea 8] s|raccolta dati utente e di sistema per file 





intervallo di tempo specifica l'intervallo di tempo da usare per la raccolta dei da- 
ti. Il tempo è specificato nel formato MSS dove M sono i minuti (da 0 a 5) 
e SS sono i secondi (da 0 a 59). Per esempio, 010 specifica un intervallo di 
10 secondi; 500 specifica un intervallo di 5 minuti. Se non viene immesso 
alcun valore, si presume un intervallo di 1 minuto. 


ampiezza file specifica la dimensione in blocchi del file di raccolta dati SMF. E’ 
possibile specificare qualsiasi numero da 1 a 312815. Se non viene specificata 


alcuna dimensione per il file, si presume una dimensione di 200. 


La terza posizione di parametro è riservata per compatibilità con il Sistema/34 
della IBM. 
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dati delle comunicazioni specifica se devono essere raccolti i dati relativi all’im- 
piego delle comunicazioni. E’ possibile specificare N o Y. 


N specifica che non devono essere raccolti i dati relativi alle comunicazioni. 
Se non è specificato alcun parametro, si presume N. 


Y specifica che devono essere raccolti i dati. 


nome file specifica il file che deve contenere i dati SMF raccolti. Se non è speci- 
ficato un nome di file, si presume SMF.LOG. 


velocità linea 1 specifica la velocità della linea di comunicazione 1 in bit al se- 
condo. Se non viene immesso alcun valore, non vengono raccolti i dati per 
quella linea, 


velocità linea 2 specifica la velocità della linea di comunicazione 2 in bit al se- 
condo. Se non viene immesso alcun valore, non vengono raccolti i dati per 
quella linea. 


velocità linea 3 specifica la velocità della linea di comunicazione 3 in bit al se- 
condo. Se non viene immesso alcun valore, non vengono raccolti i dati per 
quella linea. 


velocità linea 4 specifica la velocità della linea di comunicazione 4 in bit al se- 
condo. Se non viene immesso alcun valore, non vengono raccolti i dati per 
quelia linea. 


dati di immissione/emissione e ulteriori specifica se devono essere raccolte ulte- 
riori informazioni tipo operazioni di immissione/emissione disco, operazioni 
di immissione/emissione unità video o stampatrice, contatori di eventi di si- 
stema o il numero dei passi di lavoro avviati. E’ possibile specificare N o Y. 


N specifica che non devono essere raccolti ulteriori dati. Se non viene speci- 
ficato alcun parametro, si presume N. 


Y specifica che devono essere raccolti ulteriori dati. 


velocità linea 5 specifica la velocità della linea di comunicazione 5 in bit al secondo. 


Se non viene immesso alcun valore, non vengono raccolti i dati per quella linea 


velocità linea 6 specifica la velocità della linea di comunicazione 6 in bit al secondo. 
Se non viene immesso alcun valore, non vengono raccolti i dati per quella linea 


velocità linea 7 specifica la velocità della linea di comunicazione 7 in bit ai secondo. 
Se non viene immesso alcun valore, non vengono raccolti i dati per quella linea 


velocità linea 8 specifica la velocità della linea di comunicazione 8 in bit al secondo. 
Se non viene immesso alcun valore, non vengono raccolti i dati per quella linea 
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raccolta dati utente e di sistema per file: specifica se devono essere raccolte infor- 
mazioni addizionali sugli utenti e i file di sistema. Questa informazione com- 
prende nomi di file e di lavori, l'ubicazione del file, ed il numero di scritture e 
letture del file, Si può specificare N, Y, o U. 


N specifica che non si vogliono raccogliere dati aggiuntivi. Se non viene specifi- 
cato alcun parametro, viene assunto N. 


Y specifica che si vogliono dati aggiuntivi per file di sistema e utente. 


U specifica che si vogliono dati aggiuntivi solo per file utente. 


Esempio 
Questo esempio mostra come avviare il programma di raccolta dati SMF., | dati 


devono essere raccolti a intervalli di 15 secondi. Devono essere raccolti i dati di 
comunicazione per la linea 1 e la linea 1 ha una velocità di 1920 bit al secondo. 


SMFSTART 015,,,Y,,1920 




















Pagina lasciata intenzionalmente bianca 











CCA 





ndrinta Si 





sti mi ed ia 


PRO E SORETA 





it 





PROCEDURA SMFSTOP 
La procedura SMFSTOP interrompe il programma di raccolta dati del programma 


di supporto per rilevare le prestazioni del sistema (SMF). Per ulteriori informazio- 
ni su SMF, vedere il manuale SMF Guide, 


SMFSTOP 


La procedura SMFSTOP non ha parametri. 


Esempio 
Per interrompere il programma di raccolta dati SMF, immettere: 
SMF STOP 


E’ possibile quindi eseguire la procedura SMFPRINT per stampare i dati raccolti. 
Vedere la Procedura SMFPRINT. 
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PROCEDURA SORT 


La procedura SORT consente di selezionare i dati contenuti nei file su disco, Per 
ulteriori informazioni sulla procedura SORT e sul programma di selezione, vedere 


il manuale Programma di Selezione - SORT. 


nome file d'immissione,nome membro origine,nome file di emissione 


numero di record,|{libreria membro origine|, 
libreria corrente 


N 
Y 





nome file di immissione specifica il file da selezionare. 


nome membro origine specifica il membro origine di libreria che contiene le spe- 
cifiche di selezione da usare per selezionare il file. 


nome file di emissione specifica il file che deve contenere i record selezionati. 


numero di record specifica il numero di record da allocare al file di emissione. Il 
numero può andare da 1 a 8.000.000. 


libreria membro origine specifica il nome della libreria che contiene il membro 
origine. Se non viene specificato alcun nome di libreria, si presume la libreria 
corrente. 


N specifica che il lavoro non deve essere inserito nella coda lavori e cioè il la- 
voro deve essere eseguito dall'unità video che ha richiesto la procedura. Se 
non viene specificato alcun parametro, si presume N. 


Y_ specifica che il lavoro deve essere eseguito dalla coda di lavori, 


Esempio 


Questo esempio mostra come selezionare un file denominato FILE1. li file seie- 
zionato deve essere denominato FILE2. Le specifiche di seiezione sono in un 
membro origine denominato SORTNAME che si trova nella libreria MYLIB, 
FILE2 deve contenere fino a 200 record. 


SORT FILEl,SORTNAME,FILE2,200,MYLIB 


PROCEDURA SPECIFY 


x 


Questa procedura è supportata soltanto per compatibilità con il Sistema/34 della 
IBM. Usare la Procedura ALTERCOM per modificare ie informazioni di comuni. 
cazione. 
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PROCEDURA STARTM 


La procedura STARTM viene usata per avviare il controllo automatico di una 
linea a derivazione multipia BSC. ll Sistema/36 risponde a tutte le scansioni o 
selezioni dell'elaboratore principale su una linea a derivazione multipla BSC con 
una conferma negativa. Nella memoria centrale non è richiesto un gestore d'in- 
terruzioni non scambiabile BSC per la funzione di controllo automatico. Pertan- 
to, il Sistema/36 può essere disposto sulla lista di interrogazioni dell’elaboratore 
principale senza che alcuna funzione nel Sistema/36 venga avviata fino a che non 
è necessario. Per maggiori informazioni sulla procedura STARTM, vedere il manua- 
le Using System/36 Communications. 


x 


Il controllo automatico continua fino a che non è interrotto dalla procedura 
STOPM o fino a che non viene avviato un altro lavoro a blocchi BSC oppure non 
viene abilitato un sottosistema SSP-ICF BSC su quella linea, 


La procedura STARTM esegue il programma di utilità $SMMST. 


A 


numero linea rio Gi unità 





numero linea specifica il numero della linea che viene posta nel modo di control- 
lo automatico. E’ possibile immettere, 1, 2, 3 o 4. Questa linea deve essere 
una linea multipunti. 


E specifica che il codice di trasmissione è EBCDIC. 
A specifica che il codice di trasmissione è ASCII. 
indirizzo di unità specifica l'indirizzo (in due caratteri esadecimali) della unità 
a derivazione multipla (è possibile specifica la sequenza di interrgazione o di 
selezione). Vedere la Procedura ALTERCOM per una lista degli indirizzi 
esadecimali validi di unità a derivazione multipla. 
Esempio 


Questo esempio mostra come specificare la linea 1 come controllata automatica- 
mente per un indirizzo di unità (EBCDIC)C4. 


STARTM 1,E,Ch 


TX 


o 


STATEST 


PROCEDURA STATEST 


La procedura STATEST prova la linea di comunicazione e il dispositivo di control- 
lo usato per le unità video e le stampatrici a distanza. Essa prova inoltre i dispo- 
sitivi di controllo SSP-ICF Finance e i collegamenti secondari Peer SSP-1CF. 


E‘ possibile eseguire la prova su un collegamento commutato o non commutato. 
Su una linea a derivazione multipla è possibile provare fino a 7 unità seconda- 
rie a distanza con una singola esecuzione della prova. Per questa prova.non è pos- 
sibile usare il dispositivo di chiamata automatica. 


Il sistema sul quale si sta lavorando, trasmetterà un comando di prova alle loca- 
zioni a distanza specificate. Se le unità a distanza rispondono correttamente, 
la trasmissione riesce, Se le unità a distanza non rispondono correttamente o non 
rispondono per nulla, la trasmissione non riesce. 

. 


Dopo aver iniziato le trasmissioni di prova non è possibile porre in linea alcun 
terminale a distanza fino a che la prova non è completata. Se si vuole terminare 
la prova, premere il tasto di comando 7. 


Per informazioni sulla procedura STATEST vedere il manuale Using System/36 commu- 
nications. 


La procedura STATEST non ha parametri. 


Esempio 


Per avviare la procedura STATEST, immettere: 


STATEST 
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PROCEDURA STOPGRP 


La procedura STOPGRP arresta un singolo gruppo di sessione o tutti i gruppi di sessione 

configurati per una ubicazione remota che usi il sottosistema APPC. Il gruppo di sessio- 

ne rimane inattivo fino a che non viene eseguita la procedura STRTGRP per avviarlo 
| di nuovo. Tutte le sessioni associate con il gruppo sessione terminano quando vie- 

ne eseguita la procedura STOPGRP. Per maggiori informazioni sulla procedura 
| STOPGRP, vedere il manuale Using System/36 Communications. 


N 


STOPGRP ubicazione, [ gruppo] % 





ubicazione specifica il nome della ubicazione remota i! cui gruppo di sessione deve essere 
arrestato. 


gruppo specifica il nome di un singolo gruppo da arrestare. Se non viene specificato alcun 
parametro, vengono arrestati tutti i gruppi configurati con l'ubicazione remota. 


N specifica che il sottosistema APPC non permette all’ubicazione remota di completare 
qualsiasi richiesta prima della fine della sessione di gruppo. Se non viene specificato 
alcun parametro, viene assunto N. 


Y specifica che il sottosistema APPC permette all’ubicazione remota di completare qualsiasi 
richiesta. 
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PROCEDURA STOPM 
Questa procedura interrompe la funzione di controllo automatico di una linea a 
De derivazione multipla BSC. La linea che viene controllata, potrebbe essere stata 
precedentemente disposta in controllo automatico in uno dei tre modi: 
e Dalla procedura STARTM 
e Disabilitando un sottosistema SSP-ICF BSC 


e Terminando un lavoro a blocchi BSC. 


Per maggiori informazioni sulla procedura STOPM, vedere il manuale Using Sy- 
stem/36 Communications. 


La procedura STOPM esegue il programma di utilità $SMMSP. 


numero linea 





numero linea specifica che deve essere interrotto il modo controllo automatico 
per la linea specificata. Questa linea deve essere una linea a derivazione multipla 


Esempio 


Per interrompere la linea 1 a controllo automatico, immettere: 


STOPM 1 
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PROCEDURA STRRGRP 


La procedura STRTGRP avvia un singolo gruppo di sessione o tutti i gruppi di ses- 
sione configurati per una ubicazione remota che usi il sottosistema APPC. Per mag- 
giori informazioni sulla procedura STRRGRP, vedere . Per maggiori infor- 
mazioni sul sottosistema APPC, vedere il manuale /nreractive communications fea- 


ture reference. 





| STRTGRP ubicazione, ‘ gruppo ] 
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ubicazione specifica il nome della ubicazione remota il cui gruppo di sessione deve essere 
avviato. 


gruppo specifica il nome di un singolo gruppo da avviare. Se non viene specificato alcun 
parametro, vengono avviati tutti i gruppi configurati con l'ubicazione remota. 


SWITCH 






PROCEDURA SWITCH 


La procedura SWITCH imposta a 1 o a 0 uno o più degli interruttori UPSI (indi. 
catori di stato del programma utente) per l’unità video. La regolazione degli indi- 
catori di stato rimane valida fino a che non termina la sessione dell'unità video o 
si verifica uno dei seguenti eventi: 


® Viene elaborata un'altra procedura SWITCH 
e Viene elaborata una specifica OCL SWITCH 
e Un programma modifica la regolazione di uno qualsiasi degli indicatori. 


Tutti gli indicatori di stato sono disattivati quando inizia una sessione all'unità vi- 
deo, cioè quando l'operatore si collega, 


Un lavoro inserito in coda lavori usa una copia degli indicatori di stato per l’unità 
video nella condizione in cui si trovavano quando il lavoro è stato inserito nella 
coda. 


E’ possibile usare il comando STATUS SESSION per determinare la regolazione 
corrente degli indicatori di stato. Per determinare le regolazioni degli indicatori 
di stato in una procedura, vedere Condizioni SWITCH (Switches). 


Note: 


1. Se una procedura SSP cambia la regolazione del primo indicatore di stato, 
l'indicatore viene riportato alia regolazione originale quando la procedura 
SSP termina. 

2. Esiste una serie di indicatori di stato per ciascuna procedura a terminali ri- 
chiedenti multipli (MRT). 


La procedura SWITCH elabora una specifica OCL SWITCH. 


impostazione indicatori di stato 





impostazione indicatori di stato specifica come devono essere impostati gli indi- 
catori di stato e si compone di otto caratteri per ciascuno degli otto indica- 
tori UPSI. Il primo carattere, ossia quello più a sinistra, dà la regolazione del 
primo indicatore, il secondo dà la regolazione del secondo e così via. 


Il parametro deve sempre contenere 8 caratteri. Per ciascun indicatore di sta- 
to, deve essere usato uno dei seguenti caratteri: 


1 (uno) Attiva l'indicatore 


X Lascia l'indicatore così com'è 





Disattiva l'indicatore 
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Esempio 


Questo esempio mostra come impostare gli indicatori di stato nel modo che segue: 


Indicatore esterno Regolazione dell'indicatore 









Attivato 
Non influenzato 


Disattivato 


Attivato 





















Disattivato 












Non influenzato 


Non influenzato 





(il 
III 





SWITCH 1XO110XX 
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PROCEDURA SYSLIST 


La procedura SYSLIST cambia il metodo di listare l'emissione di lista di sistema. 
L'emissione di lista di sistema è generata da tutti i programmi di utilità SSP salvo 


i seguenti: 
e Programmi di utilità di comunicazione dati 
e Procedure di sussidio di servizio 


La procedura SYSLIST fa sì che l'emissione di lista di sistema, sia: 


e Listata sulla stampatrice che era stata assegnata all'unità video durante la 
configurazione del sistema 


e  Listata su una delle altre stampatrici 
e Visualizzata sull'unità video 
e Non listata per nulla. 


E’ possibile usare ia procedura PRINT per far sì che tutta l'emissione stampata 
vada ad una stampatrice specificata. Vedere la Procedura PRINT per ulteriori in- 
formazioni. 


L'assegnazione SYSLIST rimane in atto fino a che non ci si scoliega dal sistema 
oppure fino a quando l'assegnazione non viene cambiata da uno degli eventi se- 
guenti: 


e Un'altra procedura SYSLIST 

e La procedura PRINT 

e Una specifica OCL SYSLIST 

Note: 

1. Se la procedura SYSLIST viene eseguita durante il modo consultazione (I’o- 
peratore ha premuto il tasto Attn), la modifica effettuata dalla procedura 
SYSLIST ha effetto soltanto durante il modo consultazione. 

2. La procedura SYSLIST non cambia l'unità di lista del sistema se è attivata 


la ricerca e la correzione degli errori. Per ulteriori informazioni fare riferi- 
mento alla Specifica OCL DEBUG. 


465 


466 


SYSLIST 


La procedura SYSLIST elabora una specifica OCL SYSLIST. 


PRINTER 


CRT 


#} EXTN s| FOLD 
NOEXTN NOFOLD 


printer id 


OFF 





PRINTER specifica che l'emissione di lista di sistema deve essere listata sulla 


stampatrice che era stata assegnata all'unità video durante la configurazione 
del sistema, dalla procedura SET o dal programma di utilità $SETCF, Se non 
viene specificato alcun parametro, si presume PRINTER. 


CRT specifica che l'emissione di lista del sistema deve essere visualizzata sull'uni- 


tà video. Sono visualizzate almeno le prime 80 colonne dell'emissione. là dipendenza 
dei modello dell'unità video sono visualizzate fino a 21 righe per volta. 


Dopo ciascun schermo di lista di sistema, l'operatore può richiedere la visua- 
lizzazione della successiva ‘serie di righe oppure che la visualizzazione venga 
conclusa. Se l'operatore immette uno spazio in bianco, il numero di righe 
presentato sul successivo schermo sarà identico al numero di righe presentato 
sullo schermo precedente. Se l'operatore immette 0, la visualizzazione termi- 
na. Se l'operatore immette qualsiasi carattere diverso da uno spazio in bianco 
o da un numero da 0 a 18 (21 per l’unità video 3180 Modello 2) viene visualizzato 
il successivo set di righe. 


id stampatrice specifica che l'emissione di lista di sistema deve essere stampata 


sulla stampatrice con IID di stampatrice specificato. Gli ID di stampatrice 
sono assegnati durante la configurazione del sistema e possono essere modifi- 
cati dal comando di controllo ASSIGN. Per stampare l'emissione sulla stam- 
patrice di sistema, specifica l'ID di stampatrice della stampatrice di sistema. 


OFF specifica che non deve essere stampata o visualizzata alcuna emissione di 


lista di sistema. 


Nota: 


I parametri EXTN e NOEXTN vengono utilizzati soltanto da un sistema che usi la versione 
ideografica; in caso contrario vengono ignorati. 


FOLD specifica che la lista di emissione sistema non deve essere troncata anche se la lun- 
ghezza della riga risulta maggiore dell’ampiezza dell'unità video. Pertanto i dati oltre 
la posizione 75 vengono visualizzati sulla riga successiva. (Per l’unità video 3180 mo- 

si dello 2 vengono visualizzati sulla riga successiva i dati oltre la posizione 130). 


NOFOLD specifica che la lista di emissione sistema viene troncata se la lunghezza della 
riga è maggiore della capacità massima dell'unità video. Se non viene specificato alcun 
parametro, viene assunto. NOFOLD. 

Esempio 


Stampa dell'emissione sulla stampatrice assegnata all'unità video. 


SYSLIST PRINTER 
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PROCEDURA TAPECOPY 


La procedura TAPECOPY può essere usata per eseguire quanto segue: 


| e Copiare da disco su nastro un file di interscambio. 
I e Aggiungere un file da disco su un file nastro interscambio esistente. 
e Copiare un file di interscambio da nastro su un file su disco. 


e Aggiungere un file di interscambio da nastro ad un file su disco esistente. 


| Nota: TAPECOPY non può essere usata con una unità nastro a cassetta (TC). 
La procedura TAPECOPY esegue il programma di utilità $TCOPY. 


| Per copiare un file disco su un file nastro di interscambio: 


TAPECOPY ident.1l,|mmggaa , [ra] s [1osvp| s {ident.2|,|T1|,|giorni conservazione 
egmmaa ident.l| |T2| |l 
aammeg 


NOAUTO |, ISTDLABEL |, id volume,j FIXED , [Lungh. record], 


AUTO (SL) (F) 
NONLABEL FIXEDBLK 
(NL) (FB) 


ungh. blocco] » | REWIND , [numero sequenza | 
LEAVE 
UNLOAD 
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Per aggiungere un file da disco ad un file esistente su nastro di interscambio: 


ident.l,|mmggaa|, fa]. ADD 3 
gemmaa ADDNOCHK 


, |NOAUTO], 
AUTO 


TAPECOPY 


aommgg 


FIXED 
(F) 
FIXEDBLK 
(FB) 


[pumero se quenze | 


3 pungn. record] , Lungh. blocco] , 


ident.2|/,{T1|, 
ident.1| |T2 


STDLABEL |, id volume, 
(SL) 

NONLABEL 

(NL) 


REWIND |, 
LEAVE 
UNLOAD 





Per copiare un file di interscambio da nastro su un file su disco: 


TAPECOPY ident.l, innggaa |, sa »[Woanp], ident 2 el 
gEnmaa ident.l 1 


aammgg 


AUTO (SL) (F) 
NONLABEL FIXEDBLK | 
(NL) (FB) I 
NONSTAND VARIABLE 
(NS) (V) 
BYPASS 

(BLP) 


is A (STDLABEL , [ia volune | , | FIXED il [runen. record | } 


[punen. blocco | } [REWIND n [numero sequenza | —L-. 


LEAVE 
UNLOAD 


BLOCKS,valore2 


lunghezza chiave posiz. chiave] 'DUPKEY 
* NODUPKEY] 
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Per aggiungere un file di interscambio da nastro ad un file su disco esistente: 


ggmmaa | \T2} |NOADD ident. Egmmaa 


TAPECOPY ident.1, Innegaa faro } } idsab: | a). imdasa |; 
E 
aammgg aammss 


NOAUTO! , SIDLABEL |, [ia volume] , |FIXED 5 [rungn. record] 5 
AUTO (SL) (F) 

NONLABEL FIXEDBLK 

(NL) (FB) 

NONSTAND VARIABLE 

(NS) (V) 

BYPASS 

(BLP) 





[pungn. blocco], REWIND , [numero sequenza| 
- |LEAVE 
UNLOAD 





Ident.1 specifica i'identificazione del file da copiare. Se il file che viene copiato è 
su disco, l’identificazione non può superare gli otto caratteri. Se il file che 
viene copiato è su nastro, il numero di caratteri non può superare 17. Questo para- 
metro è necessario per un nastro LABEL STANDARD; viene inviato un messaggio 
di errore se si specifica LABEL1 ed il nastro è un nastro STANDARD LABEL. 


mmggaa, ggmmaa o aammgg specifica la data di creazione del file. Se specificata 
per il secondo parametro, si riferisce alla data di creazione del file che viene 
copiato, Se specificata per il settimo parametro, si riferisce alla data di crea- 
zione di un file esistente che è valido soltanto se viene specificato ADD o 
ADDNOCHK. La data deve essere specificata nello stesso formato della data 
di sessione. Se esiste più di un file con l’identificazione specificata e non vie- 
ne specificata una data di creazione, viene usata la data più recenti se il file 
è su disco, oppure viene usato il primo file trovato, se il file è su nastro. 


F1 specifica un file su disco. Se specificato per il terzo parametro, F1 indica che 
un file su disco viene copiato su o aggiunto ad un file su nastro. Se specifi- 
cato per il sesto parametro, F1 indica che un file su nastro viene copiato su 
o aggiunto ad un file su disco. Se vengono specificati T1 o T2 per il terzo 
parametro, per il sesto parametro si presume F1. 


T1 o T2 specifica un file su nastro. Se specificato per il terzo parametro, T1 o 
T2 indica che un file su nastro viene copiato su o aggiunto ad un file su 
disco. Se specificato per il sesto parametro, T1 o T2 indica che un file su 
disco viene copiato su o aggiunto ad un file su nastro. Se viene specificato 
F1 come terzo parametro, per il sesto parametro si presume T1. T1 indica 
che l'elaborazione deve iniziare con il nastro montato sull'unità nastro 1. 
T2 indica che l'elaborazione deve iniziare con il nastro montato sull'unità 


nastro 2. TC non è consentito con la procedura TAPECOPY. 
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ADD specifica che il file indicato nel primo parametro deve essere aggiunto al file 
indicato nel quindo parametro, Se viene aggiunto un file su nastro, viene ef- 
fettuato un controllo per assicurarsi che il file su nastro sia l'ultimo. Se il file 
su nastro non è l’ultimo, viene emesso un messaggio di errore. Questo errore 
consente di continuare, ossia di effettuare le aggiunte al file su nastro; în 
ogni caso qualsiasi altro file dopo quello che viene aggiunto andrà perso. 


ADDNOCHK specifica che il file indicato nel primo parametro deve essere ag- 
giunto ad un file esistente specificato nel quinto. ADDNOCHK è valido sol- 
tanto quando si effettua l'aggiunta ad un file su nastro e non viene effettua- 
to alcun controllo per accertarsi che si tratti dell'ultimo file su nastro. Qual- 
siasi file dopo quello che viene aggiunto andrà perso. 


NOADD specifica che il file indicato nel primo parametro sarà usato per creare 
un nuovo file di emissione. Se questo parametro viene omesso, si preme 


NOADD. 


Ident.2 specifica l’identificazione del file. Se viene specificato ADD o ADD- 
NOCKK, questo parametro si riferisce all’identificazione di un file su disco o 
su nastro esistente al quale verranno aggiunti i record. Se viene specificato 
NOADD, questo parametro si riferisce all'identificazione del nuovo file su 
disco o su nastro che viene creato, Se il file è su disco, l'identificazione non 
può superare gli otto caratteri. Se si tratta di un file su nastro, l’identificazio- 
ne non può superare 17 caratteri. Se l’identificazione supera questo limite viene 
troncata. Se questo parametro viene omesso, si presume l’identificazione specifi- 
cata nel parametro 1 (Ident. 1). 


giorni di conservazione specifica per quanti giorni si deve conservare il file su na- 
stro di recente creato. Se questo parametro non viene specificato, si presume 
un giorno. Se viene specificato un periodo di validità di 999, il file diventa 
permanente. Questo parametro è valido soltanto per i file su nastro. 


NOAUTO Se viene specificato T1 o T2, per tutti i volumi nastro verrà usata sol. 
tanto l'unità nastro specificata. 


AUTO Se viene specificato T1 o T2, quando la bobina di nastro sull'unità nastro 
originale è terminata, il sistema passa all'altra unità nastro per continuare 
l'elaborazione (da T1 a T2 o da T2 a T1). Se l’altra unità nastro non è disponibile, 
viene utilizzata di nuovo quella originale. Una richiesta di verifica viene inviata per 
controllare che la bobina nastro montata è quella giusta. Se questo parametro vie- 
ne omesso, si presume A UTO. 


STDLABEL o SL specifica che il nastro da elaborare ha una identificazione stan- 
dard. Se un file su mastro deve essere copiato su o aggiunto ad un file su di- 
sco, oppure se un file su disco deve essere aggiunto ad un esistente file su 
nastro, la maggior parte delle informazioni necessarie per elaborare i! nastro 
possono essere ricavate dall'identificazione del file del nastro. Se deve essere 
copiato un file da disco a nastro, tutte le informazioni necessarie per elabo- 
rare il file devono essere fornite o ricavate dal file su disco. Se questo para- 
metro viene omesso, si presume STDLABEL. 


NONLABEL o NL specifica che il nastro da elaborare è un nastro non identifica- 
to e devono essere fornite tutte le informazioni necessarie per elaborare il 
file. 


. 


NONSTAND o NS specifica che il nastro che deve essere elaborato ha delle iden- 
tificazioni non standard e che dovranno essere fornite tutte le informazioni 
necessarie per efaborare il file, NONSTAND è valido soltanto quando un file 
su nastro viene copiato su o aggiunto ad un file su disco. 


BYPASS o BLP specifica che il nastro ha delle identificazioni standard, ma l’ela- 
borazione delle identificazioni deve essere saltata. Devono essere fornite tutte 
le informazioni necessarie per elaborare il file. BYPASS è valido soltanto 
quando un file su nastro viene copiato su o aggiunto ad un file su disco. 
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id volume specifica l’identificazione di volume del nastro da elaborare, L'ID di 
volume può contenere da 1 a 6 caratteri alfanumerici. E’ usato per control- 
lare che sia montato il volume di nastro corretto. In caso contrario, viene 
inviato un messaggio di errore. L'operatore può continuare ad elaborare il 
file, ritentare dopo aver montato il nastro corretto, oppure cancellare la 
procedura. 


Il parametro ID volume è indispensabile se un file su disco viene copiato su 
o aggiunto ad un file su nastro con identificazione standard. Questo parame- 
tro non è ammesso se viene specificato NONLABEL, NONSTAND o BY- 
PASS. 


Se un file su disco viene copiato su o aggiunto ad un file su nastro ed il file 
richiede più di un volume di nastro, viene esaminato l'ID di volume del pri- 
mo volume, 


FIXED o F specifica che il formato del record da elaborare è a record sbloccati di 
lunghezza fissa. Se il formato record non è specificato, si assume FIXED salvo 
che si stia leggendo o aggiungendo su un file ad identificazione standard (REEL- 
SL) che ha l’identificazione HDR2. Se sul file è presente HDR2, viene usato 
il formato record specificato in HDR2. 


FIXEDBLK o FB specifica che il formato dei record del file da elaborare è a 
record bloccati, lunghezza fissa, 


VARIABLE o V specifica che il formato dei record del file da elaborare è a re- 
cord sbloccati, di lunghezza variabile. VARIABLE è valido soltanto quando 
un file su nastro viene copiato su o aggiunto ad un file su disco. 


Nota: Se // tipo di elaborazione è STDLABEL ed il formato di record specificato 
fo assunto per difetto) non corrisponde a quello nell’identificazione del file su 
nastro, viene emesso un messaggio di errore. 


lunghezza record specifica il numero di byte in un record logico su nastro. Per 
i record di lunghezza variabile, questa è la lunghezza massima. Il valore spe- 
cificato può andare da 18 a 4096 byte. 


Il parametro lunghezza record è indispensabile se è specificato NONLABEL, NON- 
STAND, BYPASS o STDLABEL e il file da elaborare non ha l‘identificazione 
HDR2, ed un file su nastro viene copiato o aggiunto ad un file su disco. Inoltre, 
il parametro lunghezza record è indispensabile se è specificato NONLABEL ed 
un file su disco viene aggiunto (non copiato} ad un file su nastro. 


Se la lunghezza di record non è specificata, quando viene creato un nuovo 
file su nastro sarà identica a quella del file su disco. Se è specificata la lun- 
ghezza record quando viene creato un nuovo file su nastro e non è identica 
a quella di un file su disco, viene emesso un messaggio di errore. Il lavoro 
può essere cancellato oppure può essere continuato ed il record su disco ver- 
rà completato o troncato alla lunghezza di record specificata. Se la lunghezza 
di record non è specificata quando il file su nastro viene copiato su o aggiun- 
to al file su disco oppure un file su disco viene aggiunto ad un file su nastro, 
la lunghezza record è ricavata dall’identificazione del file su nastro. Se viene 
specificata, la lunghezza record deve essere identica alla lunghezza record 
nell'identificazione del file su nastro. 


lunghezza blocco specifica il numero di byte in un blocco fisico di dati del file su 
nastro. Il valore specificato può andare da 18 a 32.767 byte. Questo parame- 
tro è indispensabile se era stato specificato FIXEDBLK (FB), ed erano stati spe- 
cificati anche NONLABEL (NL), NONSTAND (NS) o BYPASS (BLP). È anche ri- 
chiesto quando viene creato un nuovo file su nastro ed il formato di record è 
FIXEDBLK (FB). 


ST 


La lunghezza del blocco è necessaria se il nastro è un nastro STDLABEL (SL) 
senza l’identificazione HDR2. La lunghezza del blocco è facoltativa quando un 
file su nastro viene copiato 0 aggiunto ad un file su disco, oppure un file su di- 
sco viene aggiunto ad un file su nastro e viene specificato STDLABEL (SL). Se 
la lunghezza blocco non è specificata, viene ricavata dall’identificazione del na- 
stro. Se è specificata, deve essere identica alla lunghezza blocco nell'identifi- 
cazione del file su nastro. 


La lunghezza blocco non è ammessa se viene specificato FIXED (F) o VARIA- 
BLE (V). Se si specifica una lunghezza blocco maggiore dell’ampiezza della re- 
gione viene inviato un messaggio di errore. 


REWIND specifica che il nastro deve essere riavvolto dopo che è stata eseguita la proce- 
dura TAPECOPY. Si presume REWIND se questo parametro non viene specificato. 


LEAVE specifica che il nastro deve essere lasciato dov'è dopo che è stata eseguita la 
procedura TAPECOPY. La successiva operazione su nastro inizia da questa posizione. 


UNLOAD specifica che il nastro deve essere riavvolto e scaricato dopo che è stata 
eseguita la procedura TAPECOPY, 


numero sequenza specifica quale file su nastro elaborare in base alla posizione 
sul nastro, Se questo parametro. viene omesso e vengono specificati NON- 
LABEL, NONSTAND o BYPASS, viene assunto un numero di sequenza di 
1. Se questo parametro è omesso e viene specificata STDLABEL, il file verrà 
trovato con la sua identificazione di file. Se è specificato il numero di se- 
quenza ed è specificato anche STDLABEL, il file è individuato innanzitutto 
dal numero di sequenza, quindi controllato dall’identificazione del file. Se 
non è quelto corretto, il file viene individuato con la sua identificazione di 
file, 


RECORDS, valore] specifica che il file su disco che viene creato deve essere suffi- 
cientemente ampio per contenere il numero di record specificati dal valore 1. 
È possibile specificare un valore da 1 a 8000000. Se il file su nastro vie- 


ne copiato su un nuovo file su disco, è indispensabile usare RECORDS,valo- 
rel o BLOCKS,valore2. 


BLOCKS,valore2 specifica che il file su disco che viene creato deve essere suffi- 
cientemente ampio per contenere il numero di blocchi richiesti dal valore2. È 
possibile specificare un valore da 1 al numero massimo di blocchi di memoria 


disco configurati sul sistema. Se un file su nastro viene copiato su un nuovo : 


file su disco, è indispensabile usare RECORDS,valore1 e BLOCKS,valore2. 


lunghezza chiave specifica la lunghezza della chiave del file a indici che viene 
creato. Il valore specificato può essere qualsiasi numero decimale da 1 a 120. 
La lunghezza chiave deve essere specificata con una posizione chiave e la 
somma della lunghezza e della posizione chiave non può superare la lunghez- 
za del record più uno. Questo parametro non è ammesso quando si crea un 
file, lo si aggiunge ad un file su nastro o lo si aggiunge ad un file su disco. 


posizione chiave specifica lo spostamento relativo della posizione iniziale della 
chiave di record per il file a indice che viene creato, La locazione chiave 
deve essere specificata con la lunghezza chiave e la somma della locazione e 
della lunghezza chiave non può superare la lunghezza del record più uno. 
Questo parametro non è ammesso quando si crea un file o lo si aggiunge ad 
un file su nastro o ad un file su disco. 
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DUPKEY specifica che nel file a indici che viene creato possono essere ammesse 
chiavi doppie. Se il file che viene creato non è a indici, questo parametro è 
ignorato. Se questo parametro non è specificato al momento della creazione 
del file disco a indici, viene assunto NODUPKEY. 


NODUPKEY specifica che nel file a indici che viene creato, non sono ammesse 
chiavi doppie. Se il file che viene creato non è a indici, questo parametro 
viene ignorato. Se questo parametro non viene specificato al momento della 
creazione del file disco a indici, viene assunto NODUPKEY. 


Esempio 1 


Questo esempio prende un file su disco denominato FILE1 e lo copia su nastro. 
Il nome del file su nastro deve essere FILE2, Il nastro deve essere elaborato come 
nastro con identificazioni standard con un ID di volume VOL001 ed è montato 
sull'unità nastro 1. Il nastro dovrebbe essere riavvolto dopo la copia del file. 


TAPECOPY FILEl,,F1,NOADD,FILE2,T1,,,STDLABEL,VOLOOl 


Esempio 2 


Questo esempio prende un file da nastro che contiene 500 e lo copia su un file 
su disco. Il nome del file su nastro è FILE2 ed il file da creare su disco è chia- 
mato FILE1, II nastro ha delle identificazioni standard con un ID di volume 
VOLO001 ed è montato sull'unità nastro î. Riavvolgere il nastro dopo aver creato 
il file su disco. 


TAPECOPY FILE2,,T1,,FILE1,F1,,,,VOLO01,,,,, RECORDS, 500 


PROCEDURA TAPEINIT 


La procedura TAPEINIT prepara un nastro in modo da poterlo usare per salvare 
il file e le librerie, Questa preparazione è detta inizializzazione. E’ inoltre possi- 
bile usare questa procedura per cancellare un nastro. 


La procedura TAPEINIT esegue il programma di utilità $TINIT, 


T2 (SL) CLEAR 
NONLABEL 
(NL) 


dia STDLABEL), ia volume], CHECK], 


fia utente] , ERASE }, [REWIND 
NOERASE| |UNLOAD 





T1 specifica che il nastro da preparare si trova sull'unità nastro 1. 


T2 specifica che il nastro da preparare si trova sull’unità nastro 2. 


TC specifica che il nastro da preparare è un nastro a cassetta. Se è specificato TC, 
il solo valore formato consentito è STDLABEL (SL). 


STDLABEL o SL specifica che deve essere preparato un nastro con identificazio- 
ne. 


NONLABEL o NL specifica che deve essere preparato un nastro non identificato. 


id volume: specifica l’identificazione volume che è scritta sul nastro. E’ possibile 


specificare fino a sei caratteri alfanumerici. I! parametro è indispensabile se 
è specificato STDLABEL {SL} e non è ammesso se è specificato NONLABEL 
(NL). 


CLEAR specifica che deve essere scritta una nuova identificazione di volume 
senza controllare che si tratti di un file scaduto. 


CHECK specifica che viene esaminato il primo file di dati per vedere se si tratta 
# di un file scaduto, Se lo è, viene scritta una nuova identificazione di volume. 
Se il file non è scaduto, viene emesso un messaggio di errore, Non deve esse- 


re specificato CHECK per nastri vuoti. Se questo parametro non è specifi 
cato, si presume CHECK. 


id utente specifica un campo di identificazione addizionale. E’ possibile specifi- 
care un massimo di 14 caratteri. Se non viene specificato un ID utente, il 
campo viene lasciato in bianco. L'1D titolare non è ammesso se è specificato 
NONLABEL. 


ERASE specifica che dopo aver scritto la nuova identificazione di volume, devo- 
no essere scritti spazi in bianco alla fine del nastro, 


NOERASE specifica che non devono essere scritti spazi in bianco fino alla fine 
del nastro, dopo che è stata scritta la nuova identificazione di volume. Se 
questo parametro non viene specificato, si presume NOERASE. Questo para- 


metro non è consentito, se è specificato TC. 
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REWIND specifica che una volta che il nastro è stato preparato, deve essere riav- 
volto. Si presume REWIND, se questo parametro non viene specificato. 


UNLOAD specifica che una volta che il nastro è stato preparato deve essere riav- 
volto e scaricato. Se sono specificati UNLOAD e TC, il nastro verrà riavvolto 
dopo l'elaborazione. 


Esempio 


Questo esempio mostra come inizializzare un nastro sull'unità nastro 1. Il nastro 
deve essere inizializzato come nastro con identificazioni standard con un ID di 
volume VOL001. ll nastro deve essere esaminato per assicurarsi che il primo file 
di dati sia un file scaduto. Il nastro deve essere cancellato e quindi riavvolto e 
scaricato. 


TAPEINIT T1,SL,VOLOO1,,,ERASE,UNLOAD 
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PROCEDURA TAPESTAT 


La procedura TAPESTAT può essere usata per visualizzare o stampare informa- 
zioni relativi a volumi di nastro che sono state annotate nelle registrazioni 'statisti- 
che di volume. Se ci sono probiemi nel leggere dal o nello scrivere sul nastro spe- 
cificato, la procedura TAPESTAT può essere usata per aiutare a stabilire quali 
tipi di errori il nastro sta producendo. Se il nastro da controllare è sull'unità 1 o sul- 
l’unità 2, possono essere visualizzate e stampate le seguenti informazioni: 


Unità nastro usata 

Arco di tempo del record incontrato 

II numero di matricola del volume 

Il numero dei K-byte letti 

II numero dei K-byte scritti 

Il numero degli errori di lettura permanenti 
II numero degli errori di scrittura permanenti 
Il numero degli errori di lettura provvisori 

ll numero degli errori di scrittura provvisori 
Il numero dei tentativi degli errori di lettura 
Il numero dei tentativi di errori di scrittura 
I{ numero dei caratterì persi 

Il numero dei controlli di velocità 

Il numero degli errori multipista 

Il numero dei controlli di fine dati 

Il numero dei controlli di inizio lettura 

II numero dei guasti di rilettura 

Il numero dei controlli di avvoigimento 

Il numero degli errori di assenza di puntatore 
Ii numero degli errori per pieghe nastro 

Il numero degli errori di allineamento testina 
Il numero degli errori pista 4 

Il numero degli errori pista 5 


Il numero degli errori di controllo di validità 


Se il nastro da controllare è un nastro a cassetta, possono essere visualizzate e stam- 
pate le seguenti informazioni: 


L'unità nastro usata 
L'arco di tempo del record incontrato 


Il numero di matricola del nastro 
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TAPESTAT { 
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e La data 


e L'ora 

e Il mumero di K-byte letti 

e ll numero di K-byte scritti 

e ll numero degli errori di lettura permanenti 
e Il numero degli errori di scrittura permanenti 
e li numero degli errori dati 

e ll mumero di underrum 

e li numero di errori di validità in lettura 

e Il numero di errori di validità in scrittura 

e Il numero di tentativi di validità in lettura 

e Il numero di tentativi di validità in scrittura 


TL 
T2 





b PRINTER saarla aata |, [pers 'ora] [arse asta |, [all'ora] 
CRT 


id stamp. 


T1 specifica che il nastro da controllare si trova sull'unità nastro 1. 


T2 specifica che il nastro da controllare si trova sull'unità nastro 2. 
TC specifica che il nastro da controllare è un nastro a cassetta. 


PRINTER specifica che deve essere usata la stampatrice di sistema per stampare 
il prospetto. Se questo parametro non viene specificato, si presume PRIN- 
TER, 


CRT specifica che per visualizzare il prospetto verrà usato il terminale video dal 


quale è. stata immessa la procedura, Vengono visualizzati soltanto i primi 80 
caratteri del prospetto. 


id stampatrice specifica che il prospetto deve essere stampato sulla stampatrice 
con l'ID specificato. Gli ID di stampatrice sono assegnati durante la confi- 
gurazione dei sistema e possono essere modificati dal comando di controllo 
ASSIGN, 


dalla data specifica la data della prima entrata sui nastro da includere nel pro- 
spetto. La data deve essere specificata nel formato della data di sessione. Se 
questo parametro non viene specificato, la data dell'entrata non viene esa- 
minata, 


dall'ora specifica l'ora della prima entrata su nastro da includere nel prospetto. 
L'ora deve essere specificata nel formato hhmmss (ore-minuti-secondi). Se 
questo parametro non viene specificato, l'ora dell'entrata non viene esami- 
nata. 


alla data specifica la data dell'ultima entrata su nastro da includere nel prospet- 


to. La data deve essere specificata nel formato della data di sessione. Se. 


questo parametro non viene specificato, la data delle entrate non viene esa- 
*S minata, 


all’ora specifica l'ora dell'ultima entrata su nastro da includere nel prospetto. 
L'ora deve essere specificata nel formato hhmmss f{ore-minuti-secondi). Se 


questo parametro non viene specificato, non viene esaminata l'ora delle en- 
trate, 


Esempio 


Questo esempio mostra come controllare il nastro sull'unità nastro 1. Devono 


essere esaminate tutte le entrate sul nastro, I! prospetto deve essere stampato 


sulla stampatrice P2. 


TAPESTAT T1,P2 


PROCEDURA TEXTCONV 


La procedura TEXTCONV avvia l'ausilio conversione testi per convertire i do- 
cumenti creati dal TMS (TEXT MANAGEMENT SYSTEM] in una forma utilizza- 
bile dal DW/36. 


TEXTCONV 


La procedura TEXTCONV non ha parametri. 
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PROCEDURA TEXTDCT 


TEXTDCT 


La procedura TEXTDCT consente di gestire un dizionario aggiuntivo con il DW/36. 


Per maggiori informazioni sul DW/36 vedere l'informazione in linea. Per leggere l’infor- 
mazione in linea: 


* Eseguire la procedura READINFO. Per il DW/36 specificare: 
READINFO # WPDOC ,# WPFLDR 
e Scegliere l'opzione 11 dal menù di utilizzo DW/36 


e Premere il tasto di ausilio su qualunque schermo DW/36 


La procedura TEXTDCT non ha parametri. 


PROCEDURA TEXTDOC 
La procedura TEXTDOC permette di creare e gestire un documento utilizzando il DW/36. 


Per maggiori informazioni sul DW/36 vedere l'informazione in linea. Per leggere l’infor- 
mazione in linea: 


® Eseguire la procedura READINFO. Per il DW/36 specificare: 


READINFO # WPDOC ,# WPFLDR 


e Scegliere l'opzione 11 dal menù di utilizzo DW/36 


® Premere tasto di ausilio su qualunque schermo DW/36 


Se si immette TEXTDOC senza parametri, viene visualizzato lo schermo Lavoro con 
documenti: 


Per creare o gestire un documento 


DELETE 
PAGINATE 
REVISE 
VIEW 


TEXTDOC | CREATE {pone documento |, [nome cartella | 





Per copiare un documento su un'altra cartella 


TEXTDOC COPY [nome documento] : [nome cartelie| , | nome documento nuovo] , 
nome documento 


nome cartella nuova | , | NOREPLACE 
nome cartella REPLACE 





| Per combinare tra loro dati da altri documenti o file nel proprio documento: 


TEXTDOC MERGE [nome documento | nome cartella] ,«j nome documento nuovo| , 
nome documento 








nome cartella REPLACE OPTIONS 


nome cartella ui ca ; Re] 
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Per stampare un documento 






TEXTDOC PRINT, nome documento [none carterte|, NOOPTIONS 
OPTIONS 





Per ridenominare un documento 


TEXTDOC Rex, [ none documento , [pone cartella| , [none nuovo docunento| 





Per stampare documenti su un file disco: 


TEXTDOC PRTFILE nome documento |, [none carte ,j CHECK |scet stato S 
ALL NOCHECK 


[nuovo sato | , | TEXT ; [nome te | ERRLOG ,} DELETE 


NOTEXT NOERRLOG NODELETE 





CREATE specifica che si vuole creare un documento nuovo. 

DELETE specifica che si vuole rimuovere un documento da una cartella. 

PAGINATE specifica che si vogliono modificare i finali di pagina di un documento nuovo. 
REVISE specifica che si vuole revisionare un documento. 


VIEW specifica che si vuole guardare un documento. 


COPY specifica che si vuole copiare un documento su un altro documento. È possi- 
bile copiare sulla stessa cartella se viene indicato un nome documento diverso. 


| MERGE specifica che si vogliono combinare tra loro dati di file in un altro documento. 
PRINT specifica che si vuole stampare un documento. 


RENAME specifica che si vuole dare un nuovo nome ad un documento esistente. 


| PRTFILE specifica che si vuole stampare uno o più documenti su un file disco. 


nome documento specifica il documento con cui si vuole lavorare, Se è specificato 
PRTFILE, il nome indica il nome documento che si vuole in emissione sul file 
disco. 


nome cartella specifica la cartella in cui il documento è memorizzato o si vuole memo- 
rizzare. 
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ALL specifica che si vogliono elaborare tutti i documenti di una cartella o tutti quelli 
con un valore di stato assegnato. 


nome cartella specifica la cartella in cui il documento è memorizzato o deve essere 
memorizzato. Se è specificato PRTFILE, il nome indica il nome della cartella 
che contiene il documento che si vuole elaborare. Se non'specificato, viene 
utilizzata la cartella del profilo utente. ! 


nome nuovo documento specifica il nome del nuovo documento. Un nome documento 
non può essere più lungo di 8 caratteri e deve iniziare con un carattere alfabetico 
(da A a Z, #, $ d @). | rimanenti caratteri possono essere qualsiasi combinazione 
di caratteri (numerici, alfabetici e speciali). Non è consentito usare i seguenti carat- 
teri perchè essi hanno un particolare significato nelle procedure: virgole (,), apici 
('), spazi in bianco, punti interrogativi (?), barre (/), segni di maggiore (>), segni 
di uguale (=) e trattini (-). Non è possibile utilizzare DIR, LIBRARY o ALL come 
nomi di documenti. 


NOOPTIONS specifica che devono essere utilizzate le opzioni di stampa. Se non 
viene specificato alcun parametro, viene assunto NOOPTIONS. Se il primo pa- 
rametro è MERGE, NOOPTIONS indica che devono essere prese le opzioni as- 
sunte automaticamente del MERGE. 


OPTIONS specifica che le opzioni di stampa devono essere visualizzate prima della 
stampa del documento. Se si modificano queste opzioni quando vengono vi- 
sualizzate, tali modifiche hanno effetto solo per quel documento. Le modifiche 
non vengono salvate. Se il primo parametro è MERGE ed è indicato OPTIONS, 
viene visualizzato lo schermo OPZIONI MERGE, per poter immettere quelle in- 
formazioni utili ad indicare come deve essere effettuato il MERGE per il nuovo 
documento. 


nome cartella nuovo specifica il nome della cartella su cui deve essere memorizzato 
il documento. Se al documento si da un nome di documento già esistente, si 
deve specificare un nome diverso per la cartella precedente. Se non specifica- 
to, viene utilizzato il nome cartella. Il nome di cartella segue le stesse regole 
del nome documento. 


NOREPLACE specifica che se il nome del documento già esiste, viene inviato un mes- 
saggio di errore. Se non viene specificato alcun parametro, viene assunto NOREPLACE. 


REPLACE specifica che se il nome del documento già esiste, dovrà essere rimpiazzato. 


CHECK specifica che deve essere controllato lo stato del documento. Questo para- 
metro è valido soltanto se è specificato PRTFILE. Se non specificato verrà as- 
sunta la richiesta dal profilo utente. 


NOCHECK specifica che non si vogliono fare selezioni in base allo stato del 
documento. 


Questo parametro è valido soltanto se è specificato PRTFILE. Se non specificato, 
verrà assunta la richiesta dal profilo utente. 


scelta stato specifica il campo stato dei documenti che si vogliono selezionare. Que- 
sto parametro è valido soltanto se è specificato CHECK. Se non specificato, 
verrà assunta la richiesta dal profilo utente. 


nuovo stato specifica il nuovo valore per il campo stato dei documenti selezionati. 
Se non si vuole modificare questo valore, specificare lo stesso valore indicato 
nel parametro scelta stato. Questo parametro è valido soltanto se è specifica- 
to CHECK. Se non specificato, verrà assunta la richiesta dal profilo utente. 
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484.1.1 


TEXT specifica che si vuole includere il testo del documento nell’informazione do- 
cumento del file. Questo parametro è valido soltanto se è specificato PRTFILE. 
Se non specificato, verrà assunta la richiesta dal profilo utente. 


NOTEXT specifica che si vogliono soltanto i record descrittivi del documento. Que- 
sto parametro è valido soltanto se è specificato PRTFILE. Se non specificato, 
verrà usato il valore assunto dal profilo utente. 


Nota: Se il documento era stato ricevuto per mezzo del PS/36 da un altro si- 
stema, i soli campi descrizione documento conservati sono l'oggetto, l’autore 
e la classe. 


nome file specifica il nome del file disco su cui si vuole effettuare la stampa del do- 
cumento. Questo parametro è valido soltanto se è specificato PRTFILE. Se non 
è specificato, verrà usato il valore assunto dal profilo utente. 


ERRLOG specifica che si vuole includere nel documento la registrazione errori do- 
cumento. Questo permetterà di vedere quali inconvenienti si erano verificati 
durante la creazione dell'emissione sul disco. Questo parametro è valido sol- 
tanto se è specificato PRTFILE. Se non specificato, verrà usato il valore assun- 
to dal profilo utente. 


NOERRLOG specifica che non si vuole includere nel documento la registrazione er- 
rori documento. Questo parametro è valido soltanto se è specificato PRTFILE. 
Se non specificato, verrà usato il valore assunto dal profilo utente. 


DELETEspecifica che si vuole cancellare il documento dopo la creazione del’emis- 
sione su disco. Questo parametro è valido soltanto se è specificato PRTFILE. 
Se non specificato, verrà assunta la richiesta dal profilo utente. 


NODELETE specifica che si vuole che il documento rimanga nella cartella. Questo 
parametro è valido soltanto se è specificato PRTFILE. Se non specificato, vie- 
ne assunto NODELETE. 


iS 


CR 


PESA 


| FORMATO FILE PER FILE PRTFILE 


stata come primo record in quel file. Tutti i record nel file PRTFILE hanno una lun- 


Per ogni documento DW/36 copiato su un file disco, viene creato un record di te- 
ghezza di 256 byte. 
I RECORD DI TESTATA 


Il record di testata contiene i campi che seguono: 


= Eee 
Iniziale campo o binario (B) Contenuto o descrizione 

fi se — cole ae ii 
ilari za 


Dopo i record di testata ci sono i record documento (identificati da 10 a 99). Ci 
sarà un record documento iniziale come primo record per ogni documento stampa- 
to nel file. 











RECORD DOCUMENTO INIZIALE 


Il record documento iniziale contiene i campi che seguono: 


Iniziale campo o binario (B) Contenuto o descrizione 
CI IT 








Non utilizzato (le posizioni non utilizzate sono spazi in bianco) 
Nome cartella 
Non utilizzato (le posizioni non utilizzate sono spazi in bianco) 
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| RECORD DESCRIZIONE DOCUMENTO 


Dopo i record documento ci sono i record descrizione documento. Il primo record 
descrizione documento contiene i campi che seguono: 


= alte 
Iniziale campo o binario (B) Contenuto o descrizione 

E Je [e fosse 
fe pare 


Ricevente 






O 





: 
(S) 
dW | w 
dio 

O 


In linea (1 = si, 2 = no) 
Classe 

Data completamento 
Data ultima revisione 
Data creazione 


Data esecuzione 






Data conservazione 
Progetto 

Referenze 

Parola chiave 


Stato 


Stato interno (‘‘8000”” X = stampa come identificazione, 
“0000” X = altri) 


Non utilizzato (le posizioni non utilizzate contengono spazi in 
bianco) i 
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CPN 








Î Il secondo record descrizione documento contiene i campi che seguono: 


Colonna Lunghezza : 
Iniziale campo Contenuto o descrizione 


nessi 


1 
3 
3 
1 
1 





Carattere (C) 
o binario (B) 











Identificatore record 


Descrizione 
Ea Oggetto in maiuscolo 


8 

11 4 
6 
7 
9 


Nome originale 
Non utilizzato (le posizioni non utilizzate contengono spazi in 
bianco) 


Nomi testo riassegnati (1 = si, 2 = no) 


Cancellazione testo/controlli (1 = si, 2 = no) 
Tipo DIA 


Non utilizzato (le posizioni non utilizzate sono spazi in 
bianco) 


Tipo disponibile 


20 
20 
0 


4 
2 
1 


7 









Bit 16 = DW/36 non risolto 







Bit 15 = DW/386 risolto 
Bit 14 = L2-DCS (FFT) 
Bit 13 = L3-DCA (RFT) 
Bit 12 = dati 

Bit 11 = grafici 

Bit 10 = immagini 


| 


a__Ja 





Non utilizzato (le posizioni non utilizzate sono in bianco) 


484,1.4 


E CI Mesi (schiera di 12 nomi ciascuno di 14 caratteri) 


| «RECORD FORMATO GENERALE 


Il record formato generale contiene i campi che seguono: 


Colonna Lunghezza Carattere (C) 
Iniziale campo o binario (B} Contenuto o descrizione 


Dizionari 








01 = Inglese americano 
02 = Inglese UK 
03 = Tedesco 






05 = Francese 

06 = Francese-Canada 

07 = Italiano 

08 = Spagnolo 

11 = Danese 

51 = Inglese americano legale 

52 = Inglese UK legale 

di = Inglese americano medico 
= Inglese UK medico 






















Libreria QUERY (interrogazione) 
Non utilizzato (le posizioni non utilizzate contengono spazi in 
bianco) 
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PoerN 





| RECORD FORMATO PAGINA 


| Il record formato pagina contiene i campi che seguono: 


Colonna Lunghezza 
Iniziale campo Contenuto o descrizione 


Ce ldentificatore record (30) 





Carattere (C) 
o binario (B) 





Tipo moduli prima pagina (0= corrente, 1 =carta, 2=busta) 


2 
40 
2 


3 

13 
57 
61 
63 2 











Tipo modulo per altre pagine (0= corrente, 1=carta, 
2=busta) 


Nota in calce su prima pagina (1=si, 2= no) 


N 
-_ 


73 


N 
gi 


D 
N 


N 


81 


0 
wW 












0 


(N°) 
—_ 


(<e) 
N 


= 0 N N 


Prima riga per testata 


(Le) 
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Colonna Lunghezza Carattere (C} 
Iniziale campo o binario (B) Contenuto o descrizione 


se |a su | Fans riga Psr nota a Calce 


RAR 30 I Non utilizzato (le posizioni non utilizzate contengono in bian- 
co) 





484.1.7 


CASE 


— —- — —Tr_r————6—6—P—P—P———_—_—€€— 


| RECORD FORMATO RIGA 


| I record formato riga contiene i campi che seguono: 


Colonna Lunghezza Carattere (C) 
Iniziale campo o binario (B) Contenuto o descrizione 


Cc Identificatore record (40) 



















2 Numero ID formato 


Descrizione 


_J 


E] 
[e 
TONE ITS 
es I 


Compressione ampiezza paragrafi (1=si, 2=no) 
Numero tipo stile (ID fonte) 


Righe per pollice 
Margine documento a sinistra 






Margine a destra 


Spaziatura 






2=Singolo 
3=uno e mezzo 
4 = doppia 
b=due e mezzo 
6=tripla 


8 | Ampiezza zonatura 
8 | Allineamento riga 
Bo Numero di tabulazioni (da 0 a 48) 


Schiera di posizioni di tabulazione (2 byte per ogni 
tabulazione) 


Schiera di tipi di tabulazione (1 carattere per tabulazione) 


3 = sinistra 
4= destra 
5=centro 

6 = decimale 
7=virgola 
8=due punti 


e 
ESSI E 
Sd 
SIN CNN 
na 
aaa CSS 
li 
na 


484,1.8 


Colonna 
Iniziale 


484,1.9 


Lunghezza 
campo 


Carattere (C) 
o binario (B) 


Contenuto o descrizione 

Stato numerazione riga 
1=attivato, riprendere su riga successiva 
2= attivato, ripristinare su riga successiva 
3=disattivato, continua la numerazione 
4= disattivato, sospende la numerazione 


Orientamento riga 


O=da sinistra a destra 
1=da destra a sinistra 


Non utilizzato (le posizioni non utilizzate contengono spazi in 
bianco) 





Cau 


| RIGHE DI TESTO 


I record che seguono definiscono le righe di testo (identificatori record da 50 a 77). Se su 
una riga ci sono più di 235 byte di testo, viene creato un secondo record con posizione ini- 
ziale 236. Il secondo record avrà l'indicatore di ritorno carrello impostato a 1 per si o 2 per 
no, ma l'indicatore ritorno carrello del primo record conterrà spazio in bianco (indicante 
che la riga non finisce su questo record). 


| RECORD TESTO MEZZO INDICE IN ALTO (SOPRASCRITTO) 


@ rie 
Iniziale campo o binario {B} Contenuto o descrizione 

i de Te [imitene meses 
ER | [remeesese | 
E e mete 













etc.) 
ET Jr frese 
o TE [e Tresa o cr n oo 


ee Non utilizzato (le posizioni non utilizzate contengono spazi in 
bianco) 


] RECORD TESTO IN GRASSETTO 


Colonna Lunghezza Carattere (C) 
Iniziale campo o binario (B) Contenuto o descrizione 


1 Le colonne rimanenti e le lunghezze dei campi sono le stesse descritte per il ‘’Record testo mezzo indice in alto 
{soprascritto)"” si 



















7 I RECORD TESTO MEZZO INDICE IN ALTO (SOPRASCRITTO) SOTTOLINEATO 






Colonna Lunghezza Carattere (C) 
Iniziale campo o binario (B) Contenuto o descrizione 


1 Le colonne rimanenti e le lunghezze dei campi sono le stesse descritte per il ‘Record testo mezzo indice in alto 
(soprascritto)’’ 
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— — 


| RECORD TESTO MEZZO INDICE IN ALTO (SOPRASCRITTO) SOPRABATTUTO 


Colonna Lunghezza Carattere (C) i 
Iniziale campo o binario (B) Contenuto o descrizione 


1 
1. Le colonne rimanenti e le lunghezze dei campi sono le stesse descritte per il ‘/Record testo mezzo indice in alto 
(soprascritto)’’ 










| RECORD TESTO MEZZO INDICE IN ALTO (SOPRASCRITTO) RITORNO CARATTERE 


Colonna Lunghezza Carattere (C) 
Iniziale campo o binario {B} Contenuto o descrizione 


1 Le colonne rimanenti e le lunghezze dei campi sono le stesse descritte per il ‘’Record testo mezzo indice in alto 
(soprascritto)’’ 


Î RECORD RIGA TESTO BASE 


Colonna Lunghezza Carattere (C) 
Iniziale campo o binario (B) Contenuto o descrizione 


Le colonne rimanenti e le lunghezze dei campi sono le stesse descritte per il ‘’Record testo mezzo indice in alto 
(soprascritto)’’. 
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—— — r— 


RECORD TESTO BASE IN GRASSETTO 


Colonna Lunghezza Carattere (C) 
Iniziale campo o binario (B) a o descrizione 


1 Le colonne rimanenti e le lunghezze dei campi sono le stesse descritte per il ‘Record testo mezzo indice in alto 
(soprascritto)’’. 









RECORD TESTO BASE SOTTOLINEATO 


Colonna Lunghezza Carattere (C) 
Iniziale campo o binario Ga Contenuto o descrizione 
(Re | Identificatore record (61/3 3 3 | record | Identificatore record (61/3 3 3 | 1 


1 Le colonne rimanenti e le dei dei campi sono le stesse descritte per il ‘Record testo mezzo indice in alto 
(soprascritto)’’. 












RECORD TESTO BASE SOPRABATTUTO 


Colonna Lunghezza Carattere (C) 
Iniziale campo o binario (B) Contenuto o descrizione 


1 Le colonne rimanenti e le lunghezze dei campi sono le stesse descritte per il ‘Record testo mezzo indice in alto 
{soprascritto)'”. 
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| RECORD TESTO BASE RITORNO CARATTERE 


Colonna Lunghezza Carattere (C) 
Iniziale campo o binario (B) Contenuto o descrizione 


1 Le colonne rimanenti e le lunghezze dei campi sono le stesse descritte per il ‘‘Record testo mezzo indice in alto 
(soprascritto)'”. 















| RECORD TESTO MEZZO INDICE IN BASSO (SOTTOSCRITTO) 


Colonna Lunghezza Carattere (C) 
Iniziale campo o binario (B) Contenuto o descrizione 


1 Le colonne rimanenti e le lunghezze dei campi sono le stesse descritte per il ‘‘Record testo mezzo indice in alto 
(soprascritto)”’. 


| RECORD TESTO MEZZO INDICE IN BASSO (SOTTOSCRITTO) IN GRASSETTO 


Colonna Lunghezza Carattere (C) 
Iniziale campo o binario (B) Contenuto o descrizione 


1 Le colonne rimanenti e le lunghezze dei campi sono le stesse descritte per il ‘’Record testo mezzo indice in alto 
(soprascritto)”’. 
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RECORD TESTO MEZZO INDICE IN BASSO (SOTTOSCRITTO) SOTTOLINEATO 


Colonna Lunghezza | Carattere (C) 
Iniziale campo o binario (B) Contenuto o descrizione 
Le a Identificatore record (72)! 


1 Le colonne rimanenti e le lunghezze dei campi sono le stesse descritte per il “Record testo mezzo indice in alto 
(soprascritto)””. 















RECORD TESTO MEZZO INDICE IN BASSO (SOTTOSCRITTO) SOPRABATTUTO . 


Colonna Lunghezza | Carattere (C) 
Iniziale campo o binario (B) Contenuto o descrizione 
1 |a |o | Wentiicaore record (79) 


1 Le colonne rimanenti e le lunghezze dei campi sono le stesse descritte per il ‘Record testo mezzo indice in alto 
(soprascritto)”’. 







RECORD TESTO MEZZO INDICE IN BASSO (SOTTOSCRITTO) RITORNO CARATTERE 


Colonna Lunghezza | Carattere (C) 
Iniziale campo o binario (B) a o descrizione 


Le colonne rimanenti e le lunghezze dei campi sono le stesse descritte per il “Record testo mezzo indice in alto 
(soprascritto)”. 






484.1.14 


— — _——» 








| RECORD ISTRUZIONI 


Il record istruzioni sarà utilizzato per il controllo modifica fonte e per tutti i controlli 
non riconosciuti o passati. 


= Rie 
Iniziale campo o binario (B) Contenuto o descrizione 

LES 
E [mer pese 
E E e femme 
E | Te frese sete ente 
CS SET 

bianco) 
2 


Istruzioni (possono contenere valori minori di ‘‘40’ x). 


| RECORD INIZIO REGISTRAZIONE ERRORI 


Coe: 





| Il record inizio registrazione errori contiene i campi che seguono: 


Colonna Lunghezza Carattere (C) 
Iniziale campo o binario {B}) Contenuto o descrizione 


E CO CI CI 
Te fe fonemi 
ELI 
AO CR NE 


2 







Non utilizzato (le posizioni non utilizzate contengono spazi in 
bianco) 


Cartella 


Non utilizzato (le posizioni non utilizzate contengono spazi in 
bianco) ta 


484.1.15 


















| RECORD FINE DOCUMENTO 


J Il record fine documento contiene i campi che seguono: 


Colonna Lunghezza Carattere {C) 
Iniziale campo o binario (B) Contenuto o descrizione 


Identificatore record (99) > 
pia I 
30. 






Non utilizzato (le posizioni non utilizzate contengono spazi in 
bianco) 


2 Cc | Non utilizzato (le posizini non utilizzate contengono spazi in 
bianco) 


(i 


484.1.16 


TEXTFLDR 





484.2 


PROCEDURA TEXTFLDR 
Con la procedura TEXTFLDR si può creare e gestire una cartella utilizzando il DW/36. 


Per maggiori informazioni sul DW/36 vedere l'informazione in linea. Per leggere l’infor- 
mazione in linea: 


* Eseguire la procedura READINFO. Per il DW/36 specificare: 
READINFO # WPDOC,# WPFLDR 
® Scegliere l'opzione 11 dal menù di utilizzo DW/36. 


e Premere il tasto di ausilio su. qualunque schermo DW/36 


nome cartella 


nome cartella specifica la cartella con cui si vuole lavorare. Se si vuole creare una cartel- 
la, si deve specificare un nome che già non esista nel sistema. Un nome di cartella 
non può essere più lungo di 8 caratteri e deve iniziare con un carattere alfabetico 
(da A a Z, #, $ o @). | rimanenti possono essere una qualsiasi combinazione 
di caratteri (numerici, alfabetici e speciali). Evitare di utilizzare i caratteri che seguo- 
no perchè essi hanno un particolare significato nelle procedure: virgole (,), apici 
{'), spazi in bianco, punti interrogativi (?), barre (/), segni di maggiore (>), segni 
di uguale (=) e barrette (-). Non è consentito usare DIR, LIBRARY o ALL come no- 
me di cartella. 


prassi 


TEXTLOAD 


PROCEDURA TEXTLOAD 


La procedura TEXTLOAD crea una libreria denominata #TULIB e copia il supporto 
DW/36 da minidisco a libreria. Copia anche supporto aggiuntivo nella libreria di si- 
stema (# LIBRARY). La procedura TEXTLOAD può copiare sia minidischi PID 
(centro distribuzione IBM) che minidischi creati dalla procedura TEXTSAVE. Vedere 
la procedura TEXTSAVE per informazioni sul salvataggio del DW/36 su minidisco. 


La procedura TEXTLOAD potrebbe modificare il record principale di configurazione con 
conseguente discordanza con il membro di configurazione. Per modificare il membro 
di configurazione vedere il manuale Modifica della configurazione del sistema. Si dovrà 
utilizzare la procedura CNFIGSSP per aggiungere supporto al sistema. Si può usare la 
procedura TEXTLOAD per ripristinare il supporto che era stato salvato con la procedura 
TEXTSAVE. i 


A1, A2, A3 o AA indica la preferenza del disco; cioè l’unità disco che viene esaminata 


per prima nella ricerca di spazio disponibile. Se non è disponibile sufficiente spazio 
su quell’unità, vengono esaminate le altre unità (se esistono) e # TULIB viene inse- 
rita sull'unità disco meno usata. Se non è specifica alcuna locazione, od il sistema 
dispone di più di una unità disco, #TULIB è inserita sull'unità disco meno usata. 


A1 specifica che # TULIB deve essere inserita sul primo disco, se c'è spazio dispo- 
nibile. 


A2 specifica che # TULIB deve essere inserita sul secondo disco, se c'è spazio 
disponibile. 


A3 specifica che # TULIB deve essere inserita sul terzo disco, se c'è spazio dispo- 
nibile. 


A4 specifica che # TULIB deve essere inserita sul quarto disco, se c'è spazio di- 
sponibile. 


S1,S20S3 specifica l'alimentatore a minidischi contenente il primo minidisco da usa- 


re. Se non è specificata alcuna posizione di minidisco, si presume S1. 


M1.nn o M2.nn specifica la locazione del caricatore che contiene il primo minidisco da 


Esempio 


usare. M1 indica il primo caricatore e M2 indica il secondo, nn è un valore decimale 
da 01 a 10 che identifica la focazione del minidisco nel caricatore. Specificare M1 
equivale a specificare M1.01. Specificare M2 equivale a specificare M2.01. 


Creazione di #TULIB su disco e copia del supporto DW/36 da minidisco. 





484.3 


TEXTREL 


484.4 


PROCEDURA TEXTREL 


Con la procedura TEXTREL si possono rilasciare documenti che erano stati congelati 
per una stampa successiva. 


Per maggiori informazioni sul DW/36 vedere l'informazione in linea. Per leggere l’infor- 
mazione in linea: 


e Eseguire la procedura READINFO. Per il DW/36 specificare: 
READINFO # WPDOC,#WPFLDR 


e Scegliere l'opzione 11 dal menù di utilizzo DW/36 


e Premere i tasto di ausilio su qualunque schermo DW/36 


Per rilasciare tutti i documenti di una identificazione utente: 





Per rilasciare un file e inviarlo su una stampatrice: 


USER |,| ID utente |, | numero linea |, | NUMBER |,| numero telefonico |, 
FILE nome file LIST 


NODELETE |, membro lista telefonica |,| libreria lista telefonica 
DELETE 





USER specifica che si vogliono rilasciare tutti i documenti della propria identificazione 
utente. 

FILE specifica che si vuole rilasciare uno specifico file che contiene un documento e 

spedirlo alla stampatrice 6670 o 6580. 


id utente specifica l’identificazione utente dei documenti da rilasciare. La procedu- 
ra TEXTREL può essere eseguita solo dalla consolle di sistema per rilasciare 
i documenti di altre identificazioni utente. Gli utenti possono rilasciare docu- 
menti delle proprie identificazioni utente da qualsiasi stazione video. Se l'ID uten- 
te non è specificato, vengono rilasciati i documenti del proprio ID utente. Que- 
sto parametro è valido soltanto se USER è specificato nel primo parametro. 


nome file specifica il nome del file da rilasciare. Questo parametro è valido solo se 
FILE è specificato nel primo parametro. 


numero linea specifica il numero delle linee comunicazione su cui il file contenente 
il documento deve essere spedito e stampato. Se non viene specificato alcun para- 
metro, viene assunto 1. 


NUMBER specifica che l'operatore della console di sistema deve essere chiamato per 
stabilire la comunicazione con una stampatrice. 


LIST specifica che è utilizzato Îl dispositivo di chiamata automatica e la stampatrice 
deve essere richiamata da una lista telefonica. 


NUMERO TELEFONICO specifica il numero di telefono della stampatrice a cui deve 
essere inviato il documento contenuto nel file. 


NODELETE specifica che non si vuole rimuovere il file contenente il documento dopo 
che questo è stato stampato. Se non viene specificato alcun parametro, viene as- 
sunto NODELETE. 


DELETE specifica che si vuole rimuovere il file contenente il documento dopo che que- 
sto è stato stampato. 


membro lista telefonica specifica il nome del membro della lista telefonica che contiene 
il numero di telefono della stampatrice da chiamare. 


libreria lista telefonica specifica il nome della libreria contenente il membro della lista 
telefonica. 


484.5 


PROCEDURA TEXTSAVE 


La procedura TEXTSAVE copia il supporto DW/36 su minidisco. Il supporto DW/36 vie- 
ne copiato dalle librerie # TULIB e # LIBRARY. Si può utilizzare ta procedura TEXTLOAD 
per caricare il supporto DW/36 dal minidisco di riserva. Il minidisco per contenere la 
copia salvata deve avere l'ID di volume PPTXT. 


TEXTSAVE AUTO 
NOAUTO 





S1,$2 0 $3 specifica l'alimentatore a minidischi contenente il primo minidisco da ela- 
borare. Se non viene specificato alcun parametro, si presume S1. Se viene 
specificato T1 o T2 nel settimo parametro, questo parametro viene ignorato. 


M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidisco da 
elaborare. M1 indica il primo caricatore e M2 indica il secondo, nn è un numero 
da 01 a 10 che identifica la locazione del minidisco nel caricatore. Specificare M1 
equivale a specificare M1.01; specificare M2 equivale a specificare M2.01. Se vie- 
ne specificato T1 o T2 nel settimo parametro, questo parametro viene ignorato. 


AUTO specifica quanto segue: 


e . Se viene specificato S1, S2 o S3, possono essere usati tutti e tre i singoli 
alimentatori (51, S2 e $3). L'elaborazione inizia con il minidisco nell’alimenta- 
tore specificato e continua fino al minidisco nell’alimentatore S3. Se occorro- 
no altri minidischi, viene visualizzato un messaggio e l'operatore deve inserire 
i successivi minidischi. L'elaborazione riprende col minidisco nell’alimentatore 
S1. 


e Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli ali- 
mentatori di caricatore (M1 o M2). L'elaborazione inizia con il minidisco nella 
locazione specificata e continua fino al minidisco nella locazione M2.10. Se 
occorrono altri minidischi, viene visualizzato un messaggio e l'operatore deve 
inserire i successivi caricatori. L'elaborazione riprende alla locazione M1.01. 


NOAUTO specifica quanto segue: 


® Se viene specificato S1, S2 o S3, può essere usato soltanto l'alimentatore 
specificato. Se occorrono altri minidischi, viene visualizzato un messaggio e 
l'operatore deve inserire il successivo minidisco nell’alimentatore specificato. 


e Se viene specificato M1.nn o M2.nn, può essere usato soltanto il caricatore 
specificato. L'elaborazione inizia con il minidisco nella locazione specificata 
e continua fino all'ultimo minidisco nel caricatore. Se occorrono altri minidi- 
schi, viene visualizzato un messaggio e l'operatore deve inserire il successivo 
caricatore nell’alimentatore che viene usato. L'elaborazione riprende alla pri- 
ma locazione nel caricatore. 


484.6 


PROCEDURA TOLIBR 


La procedura TOLIBR copia in una libreria un file su disco, su minidisco, su nastro 
o nastro a cassetta che contiene uno o più membri di libreria. E inoltre possibile co- 
piare nella libreria solo determinati membri di file. 


Tutti i file nel modo a settori da copiare con TOLIBR devono essere stati creati 
dalla procedura FROMLIBR o dal programma di utilità $MAINT, Se il file nel 
modo a settori è stato creato da un Sistema/34 IBM, non viene copiato alcun 
membro oggetto del Sistema/34 IBM. Se il file nel modo a settori è stato creato 
da un Sistema/32 IBM, non vengono copiati i membri oggetto. 


Ciascun membro di libreria in un file nel modo a record che deve essere copiato 
con TOLIBR, deve iniziare con la specifica COPY e terminare con la specifica 
CEND. Fare riferimento a Specifiche COPY e CEND per il formato. Le specifi- 
che COPY e’ CEND sono automaticamente inserite nei membri creati dal 
$MAINT. Occorre inserirle all’inizio e alla finé dei membri che non sono stati 
creati dal programma di utilità $MAINT o dalla procedura FROMLIBR. 


Non inserire più di una specifica CEND. Se questa si trova all'interno di un mem- 
bro, viene inviato un messaggio di errore. 


Se il file nel modo a record è organizzato come un file su disco diretto, occorre 
inserire una specifica END dopo l’ultima specifica CEND nel file, il formato delia 
specifica END è: 


/} END 
dove un solo spazio in bianco deve separare le due barrette e END. 


1 membri in un file modo record con sottotipo TXT (testo) non vengono copiati. Se 
si tenta di farlo, viene inviato un messaggio che consente di modificare il sottotipo 
in UNS (non specificato) per poter copiare il membro. 


La procedura TOLIBR esegue il programma di utilità $MAINT. 


TOLIBR nome file,jIl|,{|mmggaa , [REPLACE], nome libreria »| SÌ 
Fl| |egmmaa libreria corrente s2 


aammgg S3 
Ml.nn 


M2.nn 





AUTO » |REWIND |, nome membro » | SOURCE , [sottotipo] 


NOAUTO| |LEAVE | |nome membro,ALL| |(S) 
UNLOAD ALL PROC 
> (P) 
LOAD 
(0) 
SUBR 
(R) 
LIBRARY 
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nome file specifica il file contenente uno o più membri di libreria da copiare nel- 
la libreria. 


11 specifica che il file è su minidisco. Se non è specificato alcun parametro, si 
presume 11. 


F1 specifica che il file è su disco. 


T1, T2 o TC specifica che si tratta di un file su nastro. T1 indica che il nastro è 
montato sull'unità nastro 1. T2 indica che il nastro è montato sull'unità nastro 
2. TC indica che il nastro è un nastro a cassetta. 


mmggaa, ggmmaa o aammgg specifica la data di creazione del file contenente i 
membri da copiare. La data, se specificata, deve essere nel formato delia data 
di sessione. Usare il comando STATUS SESSION per determinare il formato 
della data di sessione. Se esiste più di un file con il nome file specificato e se 
la data non è specificata, si applica quanto segue: 


e Seera specificato o presunto Î1, viene copiato il primo file con quel no- 
me sul minidisco. 


*  Seeraspecificato T1, T2 o TC, viene copiato il primo file con quel nome 
sul nastro. ° 


. Se era specificato F1, viene copiato il file con quel nome creato più di re- 
cente. 


REPLACE specifica che se esistono già membri di libreria con il nome di libreria 
specificato, devono essere sostituiti. Se viene specificato REPLACE, i nuovi 
membri sostituiscono i membri esistenti con i nomi duplicati e non viene vi- 
sualizzato alcun messaggio relativo alle sostituzioni. 


Se non viene specificato REPLACE, i membri sono inseriti nella libreria fino 
a che non si trova un duplicato e in quel momento il sistema visualizza un 
messaggio per informare l'operatore che esiste un duplicato. In risposta al 
messaggio, l'operatore può cancellare il lavoro o continuare l'elaborazione. Se 
il lavoro viene continuato, il nuovo membro sostituisce il membro esistente 
nella libreria. Se si trovano altri duplicati durante il lavoro, i membri esistenti 
vengono automaticamente sostituiti e non viene visualizzato alcun messaggio 
per quanto riguarda i membri duplicati. 


nome libreria specifica la libreria che conterrà i membri copiati. Se non è specifi- 
cato un nome di libreria, si presume la libreria corrente. 


S1, S2 o S3 specifica l'alimentatore per minidischi contenente il primo minidisco 
da elaborare. Questo parametro è consentito solo se è specificato 11. Se non 
è specificato alcun parametro si presume S1. 


M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidi- 
sco da elaborare. M1 indica il primo caricatore e M2 indica il secondo cari- 
catore. nn è un numero da 01 a 10 che identifica la locazione del minidisco 
nel caricatore. Specificare M1 equivale a specificare M1.01; specificare M2 
equivale a specifica M2.01. Questo parametro è consentito solo se è specifi- 
cato 11. 


Ea 


AUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, è possibile usare tutti e tre i singoli 
alimentatori (S1, S2 e S3). L'elaborazione inizia con il minidisco nel- 
l'alimentatore specificato e continua fino al minidisco nell’alimentatore 
$3. Se occorrono altri minidischi, viene visualizzato un messaggio e 
l'operatore deve inserire i successivi minidischi. L'elaborazione riprende 
col minidisco nell'alimentatore S1. 


e Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli 
alimentatori di caricatore (M1 e M2). L'elaborazione inizia con il mini- 


disco nella locazione specificata e continua fino al minidisco nella loca-. 


‘zione M2.10. Se occorrono altri minidischi, viene visualizzato un mes: 
saggio e l'operatore quindi inserisce i sutcessivi caricatori. L'elaborazione 
riprende alla locazione M1.01. 


e Se viene specificato T1 o T2, quando la bobina di nastro sull'unità na- 
stro originale è finita, il sistema passa all'altra unità nastro, se disponibi- 
le, per continuare l'elaborazione (da T1 a T2 o da T2 a T1). Se l'altra 
unità nastro non è disponibile, verrà usata quella originale. Una richiesta verrà 
inviata per verificare che la bobina montata sia quella giusta. 


* Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato da mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


Se non.viene specificato alcun parametro, si assume AUTO. 


NOAUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, può essere usato soltanto l’alimentato- 
re specificato, Se occorrono altri minidischi, viene visualizzato un mes- 
saggio e l'operatore deve inserire il successivo minidisco nell’alimentato- 
re specificato, 


e Se viene specificato M1.nn o M2.nn, può essere usato soltanto il carica- 
tore specificato. L'elaborazione inizia con il minidisco nella locazione 
specificata e continua fino all'ultimo minidisco nel caricatore. Se sono 
necessari altri minidischi, viene visualizzato un messaggio e l'operatore 
deve inserire il successivo caricatore nell’alimentatore che viene usato. 
L'elaborazione riprende alla prima locazione nel caricatore. 


e Se viene specificato T1 o T2, per tutti i volumi di nastro verrà usata 
soltanto l’unità nastro specificata. 


® Seè specificato TC, il parametro AUTO/NOAUTO viene ignorato dal mo- 
mento che è disponibile soltanto l’unità nastro a cassetta. 


REWIND specifica che il nastro deve essere riavvolto dopo che è stata eseguita 
la procedura TOLIBR. Si presume REWIND se questo parametro non è spe- 
cificato. Questo parametro non è consentito se è specificato 11 0 F1. 


LEAVE specifica che il nastro deve essere lasciato dove si trova dopo che è stata 
eseguita la procedura TOLIBR. La successiva operazione su nastro inizia da quel 
punto. Questo parametro non è consentito se è specificato [1 o F1. 


UNLOAD specifica che il nastro deve essere riavvolto e scaricato dopo che è stata 
eseguita la procedura TOLIBR. Questo parametro non è consentito se è speci- 
ficato 11 o F1. Se sono specificati UNLOAD e TC, il nastro verrà riavvolto dopo 
l'elaborazione. 


id volume specifica l’identificazione di volume della bobina di nastro. 


nome membro specifica il rnembro della libreria da copiare. 


nome membro,ALL specifica che devono essere copiati i membri della fibreria i 
cui nomi iniziano con i caratteri specificati (nome membro). E’ possibile spe- 
cificare un massimo di 7 caratteri per il nome membro. 
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ALL specifica che devono essere copiati tutti i membri della libreria o nell'ambi- 


to di un certo sottotipo. Se non viene specificato alcun parametro, viene assunto ALL. 


SOURCE o S specifica che devono essere copiati soltanto i membri origine della 
libreria. Se non è specificato alcun parametro, si presume SOURCE. 


PROC o P specifica che devono essere copiati soltanto i membri di procedura 
della libreria. 


LOAD o O specifica che devono essere copiati soltanto i membri oggetto della li- 
breria. 


SUBR o R specifica che devono essere copiati soltanto i membri della sottorouti- 
ne della libreria. 


LIBRARY specifica che per il nome membro e per il sottotipo specificati devono 
essere copiati tutti i tipi di membri della libreria (SOURCE, PROC, LOAD e 
SUBR). Se non viene specificato alcun parametro, viene assunto LIBRARY. 


sottotipo specifica che i membri che vengono listati devono essere del sottotipo 
specificato. | sottotipi validi sono: 


ARP Membro auto report RPG 

ARS Membro a risposta automatica 
ASM Membro assembler 

BAP Procedura BASIC (membro origine) 
BAS Membro BASIC 

COB Membro COBOL 

DFU Membro programma di utilità file dati 
DTA Membro dati 

FMT Membro tracciato video 

FOR Membro FORTRAN 

KEY Procedura KEYS 


MNU Membro menù 

MSG Membro messaggi 

PHL Membro elenco telefonico 

RPG Membro RPG 

SRT Membro di selezione 

UNS Non specificato 

WSU Membro programma utilità terminale 

X25 Controllo collegamento commutazione a pacchetti X,25 


Esempio 1 


Copia dei membri da un file su minidisco denominato PAY in una libreria de- 
nominata MYLIB e sostituzione di qualsiasi membro duplicato senza che venga 
visualizzato un messaggio di avvertimento. 


TOLIBR PAY,,,REPLACE,MYLIB 


Esempio 2 


Copia di soli membri origine da un file su minidisco denominato PAY in una libreraia 
denominata MYLIB e sostituzione di qualsiasi membro duplicato senza che venga visua- 
lizzato un messaggio di avvertimento 


TOLIBR PAY,,,REPLACE,MYLIB,,,,SOURCE 
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Esempio 3 


Copia di un solo membro di procedura denominato XYZ da un file su minidisco PAY in 
una libreria denominata MYLIB. Invio di un messaggio di avvertimento se il nome del 


ST membro già esiste. 
TOLIBR PAY,,,,MYLIB,,,,XYZ,PROC 
Esempio 4 
Copia di soli membri COBOL da un file su minidisco PAY in una libreria denominata MY- 
LIB. invio di un messaggio di avvertimento se il nome del membro già esiste. 
TOLIBR PAY,,,,MYLIB,,,,,,COB 
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PROCEDURA TRANSFER 


La procedura TRANSFER copia su file a indice o sequenziali su disco i file su 
minidisco in formato base di interscambio o i file in formato di interscambio |. 
Essa crea inoltre file su minidisco in formato base di interscambio o file in for- 
mato di interscambio | da un file su disco a indice, diretto o sequenziale. Vedere 
File in formato base di interscambio e File in formato di interscambio I per ulte- 
riori informazioni su questi tipi di file. 


Per visualizzare o stampare un file su minidisco ìn formato di interscambio | o in 
formato base di interscambio, vedere la Procedura LYSTFILE, 


La procedura TRANSFER consente di: 


e Convertire un file su disco diretto, a indice o sequenziale in un file su mini- 
disco in formato base di interscambio o in formato di interscambio |. 


e Convertire un file su minidisco in formato base di interscambio o in formato 
di interscambio | in un file su disco a indice, sequenziale o diretto. 


e Aggiungere un file su minidisco in formato base di interscambio o in forma- 
to di interscambio | a un file su disco sequenziale esistente. 


e Aggiungere un file su disco a un file su minidisco in formato base di inter- 
scambio o in formato di interscambio | esistente. 


{ record cancellati in un file nel quale è possibile cancellare i record, non sono 
trasferiti al minidisco. Inoltre, se viene copiato su minidisco un file dal quale è 
possibile cancellare i record, tale possibilità di cancellazione verrà a mancare una 
volta che esso sarà trasferito di nuovo al disco. 


I file su disco non verranno estesi quando: sono copiati da minidisco. 


Quando un file su minidisco in formato base di interscambio o in formato di in- 
terscambio |, viene trasferito ad un file su disco a indice o sequenziale, i record 
sono inseriti nel file su disco sequenzialmente, usando la lunghezza di record del 
file su minidisco. 


Quando viene creato un file su minidisco in formato base di interscambio da un 
file su disco, la lunghezza di record del file su minidisco è uguale alla minore tra 
quella del file su disco e 128 {per il minidisco 1) o 256 (per il minidisco 2D). 
Quando viene creato un file su minidisco in formato di interscambio | da un file 
su disco, la lunghezza di record del file su minidisco è impostata uguale a quella 
del file su disco. 


Quando un file su minidisco in formato base di interscambio viene aggiunto ad 
un file su disco sequenziale esistente, viene usata la lunghezza di record del file 
su disco per tutti i record aggiunti al file. Ciò fa sì che i record nel file su mini- 
disco vengano troncati o riempiti con 0 (X'00') se la rispettiva lunghezza di re- 
cord è diversa da quella dì file su disco esistente. 


Quando viene aggiunto un file su minidisco in formato di interscambio | a un file 
su disco sequenziale esistente, la lunghezza di record del file su minidisco deve 
essere uguale alla lunghezza di record del file su disco. 


Quando un file su disco viene aggiunto ad un file su minidisco in formato base di 
interscambio o in formato di interscambio I, la lunghezza di record del file su mi- 
nidisco deve essere la stessa della lunghezza di record del file su disco. In ogni ca- 
so, quando si aggiunge un file su disco (la. cui lunghezza di record è maggiore del- 
la dimensione di settore del minidisco) a un file in formato base di interscambio 
{la cui lunghezza di record è uguale alla dimensione di settore del minidisco), i 
record dei file su disco sono troncati alla dimensione del settore, Per il minidisco 
1, la dimensione del settore è di 128 byte; per il minidisco 2D la dimensione del 
settore è 256 byte. 
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La procedura TRANSFER esegue il programma di utilità $BICR. II programma di 

utilità $BICR elabora i record sequenzialmente. Se il file di immissione è un file 

a indice e il file di emissione deve essere un file su minidisco in formato base di 

interscambio, i record sono letti sequenzialmente per chiave. Se il file di emissio- Les 
ne è un file su minidisco in formato di interscambio |, i record sono letti sequen- 

zialmente secondo l’ordine fisico sul quale figurano sul file. 


Per copiare un file su minidisco in formato base di interscambio o in formato di 
interscambio | su un nuovo file su disco: 


nome file d'immissione, |11| ,|mmegaa}, [rospo |, ; a 
gemmaa lunghezza chiave, 
aammgg posizione chiave 


5 s {Sl » \AUTO » | NODUPKEY 
RECORDS,record S2 NOAUTO DUPKEY 
BLOCKS,blocchi $3 

Ml.nn 
M2.nn 





Per aggiungere un file su minidisco in formato base di interscambio o in formato 
di interscambio | a un file su disca esistente: 


nome file d'immissione, [n] ,|nmggaa|,ADD,|nome file d'emissione |, 
semmaa nome file d'immissione 
aammgg 
[anta], Sl s AUTO 
S2 NOAUTO 
53 
Ml.nn 
M2.nn 


Per copiare un file su disco su un file su minidisco in formato base di interscam- 
bio o in formato di interscambio |: 


TRANSFER nome file d'immissione,Fl,|mmggaa |,id volume,|giorni di validità|,,, 
egmmaa 1 


aamngg i 


AUTO |,|EXCHANGE 
NOAUTO| |IFORMAT 


ÈJ 





Per aggiungere un file su disco ad un file su minidisco in formato base di inter- 
scambio o in formato di interscambio |: 


TRANSFER nome file d'immissione,Fl,| mnggaa |,id volume,|giorni di validità |, 
gEmmaa al: 
aammgg 


nome file d'immissione S2 NOAUTO IFORMAT 
LL S3 sa = 

Ml.nn 

M2. 28; 


ADD, [none file d'emissione |,|Sl AUTO , [EXCHANGE 








nome file di immissione specifica il file che viene trasferito. Se viene creato un 
nuovo file, gli viene attribuito il nome file specificato. 


{1 specifica che un file su minidisco in formato base di interscambio o in forma- 
to di interscambio |, viene trasferito ad un file a indice o sequenziale su di- 
sco. Se non viene specificato alcun parametro si presume 11. 


F1 specifica che un file su disco viene trasferito ad un file su minidisco in forma- 
to base d’interscambio o in formato di interscambio |. i 


mmggaa, ggmmaa o aammgg specifica la data di creazione del file che viene tra- 
sferito, La data, se specificata, deve essere nel formato della data di sessione; 
usare il comando STATUS SESSION per determinare il formato della data 
di sessione. Se esiste più di un file con il nome file specificato e se la data 


non è specificata, si applica quanto segue: 
e Se viene specificato 11, viene trasferito il primo file con que! nome. 


e Se è specificato F1, viene trasferito il file con quel nome creato più 
di recente, 
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NOADD specifica che il file su minidisco in formato base di interscambio o in 
formato di interscambio | che viene trasferito, diventerà un nuovo file su di- 
sco. Si presume NOADD ogniqualvolta un file viene trasferito da minidisco a 
disco. 


ADD specifica che il file di immissione deve essere aggiunto al file di emissione. 
(Il primo record del file di immissione deve seguire immediatamente l’ultimo 
record nel file di emissione). 


lunghezza chiave specifica la lunghezza di chiave del file a indice su disco che vie- 
ne creato. La lunghezza della chiave può essere qualsiasi numero da 1 a 120. 
Essa deve essere specificata con la posizione di chiave e la somma detla iun- 
ghezza di chiave e della posizione di chiave non deve superare la lunghezza 
del record. 


posizione chiave specifica la posizione iniziale detla chiave per ii file a indice su 
disco che viene creato. Per i file in formato base di interscambio, la posizio- 
ne chiave può essere qualsiasi numero da 1 a 128 per.i minidischi tipo 1 o da 
1 a 256 per i minidischi tipo 2D. Per i file in formato di interscambio I, la 
posizione della chiave può essere qualsiasi numero da 1 a 4096. La posizione 
della chiave deve essere specificata con ia lunghezza di chiave e la somma 
della lunghezza di chiave e della posizione di chiave non deve superare ia iun- 
ghezza del record. 


DUPKEY specifica che nel file a indice che viene creato .sono ammesse chiavi 
doppie. Se il file che viene creato non è a indice, questo parametro è igno- 
rato. Se questo parametro non è specificato, l'attributo del file di immissione 


sarà identico a quello del file di emissione. 


NODUPKEY specifica che non sono ammesse chiavi doppie nel file a indice che 
viene creato. Se il file che viene creato non è a indice, questo parametro vie- 
ne ignorato. Se questo parametro non viene specificato, l'attributo del file di 
immissione sarà identico a quello del file di emissione. 


RECORDS specifica che il file su disco che viene creato deve essere sufficiente- 
mente ampio per contenere il numero di record specificati. 


record specifica il numero di record per il file. Può essere specificato qual- 
siasi numero da 1 a 8.000.000. 


E’ indispensabile usare RECORDS o BLOCKS se: 
e Il file che viene trasferito si trova su più di un minidisco. 


e Il file su disco creato deve essere più grande del file:che viene trasferito. 


BLOCKS specifica che il file su disco che viene creato deve essere sufficientemen- 
te ampio per contenere il numero di blocchi specificato. 


blocchi specifica il numero di blocchi per il file. Può essere specificato qual- 
siasi numero da 1 a 312.815. 


nome file di emissione specifica il file su disco esistente al quale deve essere ag- 
giunto il file su minidisco in formato base di interscambio o in formato di 
interscambio | oppure il nome di un file su minidisco in formato base di in- 
terscambio o in formato di interscambio |-al quale devono essere aggiunti i 
record da un file su disco. Il nome file di immissione è ammesso soltanto se 
viene specificato ADD. Se non viene specificato alcun nome del file di emis- 
sione, si presume il nome del file di immissione. 


data specifica la data di creazione del file su disco esistente. La data è ammessa 
soltanto se viene specificato ADD. La data deve essere specificata nello stes- 
so formato della data di sessione. E’ possibile usare il comando STATUS 
SESSION per determinare il formato della data. 


id volume specifica l'ID di volume del minidisco. E' possibile specificare da 1 a 
6 caratteri. ù 


giorni di validità specifica ia lunghezza del periodo di validità in giorni per il file 
su minidisco creato in formato base di interscambio o in formato di inter- 
scambio i. E’ possibile specificare qualsiasi numero da 1 a 999, Se non viene 
specificato alcun periodo di validità, si presume 1 giorno. Se viene specificato 
un periodi di validità di 999 giorni, il file su minidisco è considerato un file 
permanente. Per ulteriori informazioni sulla validità dei file su minidisco, ve- 
dere la Specifica OCL FILE (per i file su minidisco). 


S1, S2 o S3 specifica l'alimentatore a minidischi contenente il primo minidisco 
da elaborare, Se non è specificato alcun parametro si presume S1. 


M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidi- 
sco da elaborare. M1 indica il primo caricatore e M2 indica il secondo cari- 
catore. nn è un numero da 01 a 10 che identifica ia locazione del minidisco 
nel caricatore. Specificare M1 equivale a specificare M1.01; specificare M2 
equivale a ‘specifica M2.01. 


AUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, è possibile usare tutti e tre i singoli 
alimentatori (S1, S2 e 53). L'elaborazione inizia con il minidisco nel- 
l'alimentatore specificato e continua fino al minidisco nell’alimentatore 
S3. Se occorrono altri minidischi, viene visualizzato un messaggio e 
l'operatore deve inserire i successivi minidischi. L'elaborazione riprende 

Pra col minidisca nell'alimentatore S1. 


e Se viene specificato M1.nn 0-M2.nn, possono essere usati entrambi gli 
alimentatori di caricatore (M1 e M2}). L'elaborazione inizia con il mini- 
disco nella locazione specificata e continua fino al minidisco nella loca- 
“zione M2.10. Se occorrono altri minidischi, viene visualizzato un mes- 
saggio e l'operatore quindi inserisce i successivi caricatori. L'elaborazione 
riprende alla locazione M1.01. 


Se non viene specificato alcun parametro, si assume AUTO. 


NOAUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, può essere usato soltanto l’alimentato- 
re specificato. Se occorrono altri minidischi, viene visualizzato un mes- 
saggio e l'operatore deve inserire il successivo minidisco nell’alimentato- 
re specificato. 


e Se viene specificato M1.nn o M2.nn, può essere usato soltanto il carica- 
tore specificato. L'elaborazione inizia con il minidisco nella locazione 
specificata e continua fino all’uitimo minidisco nel caricatore. Se sono 
necessari altri minidischi, viene visualizzato un messaggio e l'operatore 
deve inserire il successivo caricatore nell’alimentatore che viene usato. 
L'elaborazione riprende alla prima locazione nel caricatore. 


EXCHANGE specifica che il file su disco viene trasferito a un file su minidisco 
in formato base di interscambio. Se non viene specificato un parametro, si 
presume EXCHANGE. 


meta IFORMAT specifica che un file su disco viene trasferito ad un file su minidisco 
in formato di interscambio |. 
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Esempio 1 


Creazione di un file su disco sequenziale denominato FILE2 da un file su minidi- 
sco in formato base di interscambio o in formato di interscambio | denominato 


FILE2. ESS 
TRANSFER FILE2 

Esempio 2 
Creazione di un file a indice su disco denominato FILE2 da un file su minidisco 
in formato base di interscambio denominato FILE2, La chiave deve essere nelle 
posizioni da 1a 5. 

TRANSFER FILE2,,,35,1l 

Esempio 3 
Aggiunta di un file su minidisco in formato base di interscambio o in formato di 
interscambio | denominato FILE1 a un esistente file su disco denominato FILE1. 

TRANSFER FILEl,,,ADD 

Esempio 4 
Creazione di un file su minidisco in formato base di interscambio denominato 
FILE3 da un file su disco denominato FILE3. Il file deve essere salvato per 30 far 
giorni. L'ID di volume del minidisco è VOL001. 

TRANSFER FILE3,F1,,VOLO01,30 

Esempio 5 
Creazione di un file su minidisco in formato di interscambio | denominato FILE3 
da un file su disco denominato FILE3. Il file deve essere salvato per 30 giorni. 
L'ID di volume del minidisco è VOL002. 

TRANSFER FILE3,F1,,VOL002,30,,,s s FORMAT 


File in formato base di interscambio 


Quando i file su minidisco in formato base di interscambio sono copiati o creati, 
i minidischi in uso devono essere inizializzati in uno dei seguenti formati usando 
il parametro FORMAT delia procedura INIT: 


e | minidischi tipo 1 (unilaterali), devono essere inizializzati nel formato a 128 
byte per settore. 


e | minidischi 2D (minidischi bilaterali a doppia densità), devono essere inizia- 
lizzati nel formato a 256 byte per settore. 


Se il formato dei minidischi non è noto, è possibile usare la procedura CATA- 
LOG per listare il formato del minidisco, 


Questi file su minidisco possono essere usati per scambiare i dati tra sistemi e 
unità. Vedere /BM Diskette General Information Manual per informazioni sui 
campi di identificazione dei data set. i 


I record in un file in formato base di interscambio non sono bloccati e non pos- 
sono attraversare settori di minidisco, Cioè in ogni record viene usato soltanto 
un settore del minidisco (128 byte per il minidisco tipo 1, 256 byte per il mini- 
disco tipo 2D). | dati vengono troncati se la lunghezza di record è maggiore del- 
la dimensione del settore del minidisco. 


File in formato di interscambio | 


Questi file su minidisco possono essere usati per scambiare i dati tra sistemi e 
unità che supportano il minidisco in formato di interscambio |. 


Nota: È necessario il dispositivo 6000 per eseguire un trasferimento con file in for- 
mato di interscambio I. 


Quando vengono copiati i file in formato di interscambio 1, i minidischi devono 
essere inizializzati in uno dei seguenti formati usando il parametro FORMAT o 
FORMAT? della procedura INIT: 


e | minidischi tipo 1 (unilaterali) possono essere inizializzati nel formato a 
128 o a 512 byte per settore . 


e | minidischi tipo 2D {bilaterali a doppia densità), possono essere inizializzati 
nel formato a 256 o a 1024 byte per settore. 


I record in un file in formato di interscambio | sono bloccati e possono abbrac- 
ciare diversi settori del minidisco. In altre parole, parecchi record e parti di re- 

‘ cord, possono essere disposti su un settore di un minidisco oppure un record 
può estendersi da un settore ad un altro. In ogni caso, i record non possono 
estendersi su volumi diversi, 
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PROCEDURA UPDATE 


La procedura UPDATE consente di modificare un file su disco usando il DFU. 
Per definire il formato dei record nel file, vengono usate le specifiche di file. 
Per ulteriori informazioni sul DFU, vedere il manuale DFU Guide, 


UPDATE nome file,nome programma dfu, [nome membro origine file] s 


recordl,|caratteri di riempimento|,| NN], [none membro origine afu|,, 
O D 
si Z 

B 


nome libreria : [none membro origine formati video] nome Lusi 
libreria corrente © |su disco | 





nome file specifica il file da modificare. Il nome del fife può contenere da 1 a 8 
caratteri. î 


nome programma dfu specifica il programma DFU da creare per elaborare il file. 
Se il programma non esiste nella libreria, il DFU avvia le procedure d’impo- 
stazione. Se il programma esiste nella libreria, it DFU procede direttamente 
a modificare il file. 


nome membro origine file specifica il membro origine contenente la descrizione 
del file (specifiche F) e ie specifiche di immissione record (specifiche 1) che 
descrivono il file da elaborare. Questo membro può contenere una o più 
serie di descrizione di file e di specifiche di immissione oppure un intero 
programma RPG Il. La descrizione del file e le specifiche di immissione che 
corrispondono al file sono intese come descrizione di dati. 


Questo parametro è richiesto se non è specificato. E’ richiesto se il program- 
ma DFU specificato non esiste. 


record specifica il numero di record al quale il file deve essere esteso quando è 
pieno, Se non viene specificato alcun numero, si presume Q e il file non vie- 
ne esteso. 


carattere di riempimento indica se i campi numerici senza chiave devono essere 
riempiti con zeri {esadecimale FO) o con spazi in bianco. Le sole entrate 
ammesse sono D, Z o B. Se non viene specificato alcun parametro, si presu- 
me D. 


D o B specifica un file di dati con riempimento con spazi in bianco dei 
campi numerici senza chiave. 


Z specifica un file di dati con riempimento con zeri dei campi numerici sen- 
za chiave. 
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NN, NY, YY or GO indica come devono essere elaborate le specifiche origine. 
Questo parametro a due caratteri è appropriato se il programma DFU non 
esiste e deve essere eseguita l'impostazione del lavoro. Esso indica se le spe- 
cifiche DFU per questo lavoro, sono già memorizzate nella libreria e se esse 
devono essere memorizzate nella libreria al termine dell'impostazione del la- 
voro, Questo membro origine delle specifiche DFU è memorizzato o cercato 


nella libreria corrente a meno che non sia specificato un nome di libreria. 


NI le specifiche DFU memorizzate non sono usate dalla funzione di impo- 
stazione. Viene richiesto di creare le specifiche ma queste non vengono 
salvate nella libreria. 


NY le specifiche DFU memorizzate non sono usate da questa impostazione 
di lavoro. Viene richiesto di creare le specifiche; una volta create, queste 
vengono memorizzate nella libreria. 


YN le specifiche DFU memorizzate vengono usate dalla funzione di imposta- 
zione. E’ possibile aggiornare le specifiche richiamate prima che il pro- 
gramma DFU venga modificato, Se si modificano le specifiche sull'unità 
video, viene interessato soltanto questo lavoro; le modifiche non sono 
memorizzate nella libreria. 


YY le specifiche DFU memorizzate sono usate dalla funzione di impostazio- 
ne. E' possibile aggiornare le specifiche richiamate prima che venga mo- 
dificato il programma DFU. Le specifiche nella libreria sono sostituite 
dalle specifiche aggiornate. 


GO le specifiche DFU memorizzate sono usate dalla funzione di impostazio- 
ne. Non è possibile aggiornare le specifiche prima che venga modificato 
il programma DFU, a meno che non si trovino errori. Se si trovano erro- 
ri nelle specifiche, occorre correggere la specifica prima che il program- 
ma DFU venga modificato. in ogni caso le specifiche DFU memorizzate 
non vengono modificate. 


nome membro origine dfu specifica il membro origine che contiene o conterrà le 
specifiche DFU salvate. Questo parametro è richiesto se il parametro di ela- 
borazione origine DFU non è NN. 


nome libreria specifica la libreria che contiene o conterrà le specifiche DFU. Ver- 
ranno cercati o memorizzati in questa libreria tutti i membri di libreria asso- 
ciati con il lavoro DFU. Se non viene specificato questo parametro, si presu- 
me fa libreria corrente. 


nome membro origine formati video specifica il membro origine in cui il DFU 
deve memorizzare le specifiche origine tracciato video che sono state create 
quando è stato impostato il lavoro DFU. 


nome file su disco specifica il nome nella VTOC di disco del file da modificare se diverso 
dai nome specificato nel programma DFU. Se si specifica il nome del file su disco 
e non quello da modificare dal programma DFU, viene fatta una richiesta per questo 
parametro. 


Esempio 


Questo esempio mostra come modificare un file su disco denominato FILE1. 
Devono essere usate le specifiche DFU denominate DFUSETUP per elaborare il 
file. La libreria MYLIB contiene le specifiche DFU. 


UPDATE FILEl,FILEFMT,,,,GO,DFUSETUP, ,MYLIB 
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PROCEDURA WSU 


nome membro origine, |libreria membro origine],|numero blocchi], 


| HALT » east | PROC più {0 
È 


La procedura WSU genera un programma WSU dalle specifiche in un membro 
origine di libreria. Il WSU è un programma di utilità interattivo di immissione 
dati che consente di creare e aggiornare file di transazioni e di aggiornare file 
principali. Per ulteriori informazioni sul WSU, vedere il manuale WSU Guide. 





libreria corrente 50 




















NOHALT mast | | ae v, 
NOSTOP NOLISTS | |PG A 
REPLACE | [no LISTW oPos | 





nome membro origine specifica il membro origine dì libreria che contiene le 
specifiche di programma origine WSU. 


libreria membro origine specifica la libreria che contiene il membro origine. 
Se non viene specificato alcun nome di libreria, si presume la libreria cor- 
rente. 


numero blocchi specifica il numero di blocchi da usare per un file di lavoro, E’ 
possibile immettere qualsiasi numero da 1 a 9999. Se non viene immesso 
alcun numero, si presumono 50 blocchi. 


HALT specifica che se si incontra qualsiasi errore di terminazione nel program- 
ma, deve essere visualizzato un messaggio di errore. Se non viene immesso 
alcun parametro, si presume HALT. Se si trovano membri di libreria con gli 
stessi nomi dei membri di libreria generati dalla procedura WSU, un messag- 
gio visualizzato consente di sostituire il membro esistente o di cancellare la 
procedura WSU. 


NOHALT specifica che se si incontrano nel programma errori di terminazione, 
non devono essere visualizzati messaggi di errore e la procedura WSU deve 
continuare l'elaborazione. Se si trovano membri di libreria con gli stessi nomi 
dei membri di libreria generati dalla procedura WSU, un messaggio visuatiz- 
zato consente di sostituire il membro esistente o di cancellare la procedura 
WSU. 


NOSTOP è una combinazione delle funzioni NOHALT e REPLACE. La procedu- 
ra WSU continua l'elaborazione se incontra un errore di terminazione e qual- 
siasi membro di libreria esistente viene automaticamente sostituito con qual- 
siasi membro generato di recente, 


REPLACE specifica che qualsiasi membro di libreria esistente che ha lo stesso no- 
me generato dal programma, dalla procedura, dal membro origine tracciato 
video o dal membro oggetto tracciato video WSU, viene automaticamente so- 
stituito dai membri creati di recente. 


J 





LIST specifica che deve essere prodotta una lista completa di generazione del 
programma WSU. Questa lista comprende le informazioni di generazione del 
programma WSU, le informazioni di programma origine WSU, informazioni 
diagnostiche e informazioni di tracciato video. Vedere WSU Guide per ulte- 
riori particolari sulle informazioni nella lista. Se non viene specificato alcun 
parametro, si presume LIST. 


NOLIST specifica che devono essere listate soltanto le informazioni diagnostiche. 


NOLISTS specifica che devono essere listate le informazioni incluse nel parame- 
tro LIST ma che dalla lista devono essere omesse le informazioni di traccia- 
to video. 


NOLISTW specifica che devono essere listate soltanto le informazioni diagnosti- 
che e le informazioni di tracciato video. 


PROC specifica che deve essere creata la procedura che richiama il programma 
WSU generato (nonché il programma WSU e i tracciati video). Se non viene 
specificato alcun parametro, si presume PROC. 


NOPROC specifica che non deve essere creata la procedura ma che devono essere 
generati i tracciati video e il programma WSU. 


PGM specifica che deve essere generato soltanto il programma WSU. Non devono 
essere creati né una procedura né membri oggetto né membri origine traccia- 
to video. 


NOPGM specifica che non devono essere creati o sostituiti membri. E’ possibile 
Usare questo parametro per creare le liste associate alla generazione del pro- 
gramma, senza effettivamente creare il programma o altri membri di libreria. 


N specifica che il lavoro di generazione del programma WSU non deve essere inse- 
rito nella coda di lavori di immissione ma deve essere eseguito dall'unità vi- 
deo che richiede la procedura WSU. Se non viene immesso alcun parametro, 
si presume N. 


Y specifica che il lavoro di generazione programma WSU deve essere inserito nel- 
la coda di lavori di immissione, ° 
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0, 1 o 2 specifica quante informazioni devono essere incluse nella lista di genera- 


Esempio 


zione dei programma WSU. Se non viene immesso alcun parametro, si presu- 
me 1, Vedere la WSU Guide per ulteriori informazioni, - 


0 specifica che devono essere listate le seguenti informazioni: 


Informazioni sulla generazione del programma WSU 
Informazioni sul programma origine WSU 

Informazioni diagnostiche 

Indicatori non definiti 

Nomi campo definiti più di una volta 

Nomi campo non definiti 

Fabbisogno di memoria centrale 

Fabbisogno di memoria su disco 

Procedura creata per l'esecuzione del programma WSU generato 
Testo diagnostico 


1 specifica che devono essere listate le seguenti informazioni: 


Tutte le informazioni listate per il parametro 0 

Gli indicatori usati 

Gli indicatori a cui non si è fatto riferimento 

I codici di identificazione messaggio dei membri messaggi usati 
I nomi di campo dati usati a livello modo 

I nomi di campo dati usati a livello sessione 

I nomi di campo dati usati a livello lavoro 

I nomi usati per le identificazioni di programma 

I nomi dei campi cui non si è fatto riferimento 


2 specifica che devono essere listate le informazioni seguenti: 


Tutte le informazioni listate per il parametro 1 
I riferimenti incrociati per gli indicatori 
I riferimenti incrociati per i nomi di campo e per le identificazioni. 


Questo esempio mostra come generare un programma WSU denominato PROC], 
una lista completa e la procedura usata per eseguire il programma, li membro 
origine si trova nella libreria corrente. 


WSU PROG1,,,,33,2 


PROCEDURA WSULOAD 


La procedura WSULOAD crea una libreria denominata #WSULIB e copia il sup- 
porto WSU dal minidisco in quella libreria. WSULOAD copia ulteriore supporto 
nella libreria di sistema (#LIBRARY). La procedura WSULOAD può copiare mi- 
nidischi PID (Program Information Department) o minidischi creati dalla proce- 
dura WSUSAVE. Vedere la Procedura WSUSAVE per informazioni sul modo in 
cui salvare su minidisco il supporto WSU. 


La procedura WSULOAD potrebbe modificare il record di configurazione princi. 
pale con il risultato che potrebbe non esserci un corrispondente membro di con- 
figurazione. Per modificare il membro di configurazione per adeguarlo al record 
di configurazione principale, vedere il manuale Modifica della configurazione del 
sistema. Si dovrebbe normalmente usare la procedura CNFIGSSP per aggiungere 
supporto al sistema. E’ inoltre possibile usare la procedura WSULOAD per ripri- 
stinare il supporto che era stato precedentemente salvato dalla procedura WSUSAVE. 


WSULOAD 





A1, A2, A3 0 AA indica la preferenza del disco; cioè l’unità disco che viene esa- 
minata per prima alla ricerca di spazio disponibile. Se non è disponibile suf- 
ficiente spazio su quell’unità, vengono esaminate altre unità (se esistono) 
e #WSULIB viene inserita sull'unità disco meno usata, Se non è specificata 
alcuna locazione ed il sistema ha più di un'unità disco, AWSULIB viene 
inserita sull'unità disco meno usata. 


A1 specifica che # WSULIB deve essere inserita sul primo disco, se è disponibile 
spazio. 


A2 specifica che # WSULIB deve essere inserita sul secondo disco, se è disponibi- 
le spazio. 


A3 specificache # WSULIB essere inserita sul terzo disco, se è disponibile spazio. 


A4 specifica che # WSULIB deve essere inserita sul quarto disco, se è disponibile 
spazio. 


S1, S2 o S3 specifica l'alimentatore per minidisco contenente il primo minidisco 
da usare. Se non è specificata alcuna posizione di minidisco, si presume S1. 
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WSUSAVE 


M1.nn o M2.nn specifica ia locazione del caricatore contenente il primo minidi- 
sco da elaborare. M1 indica il primo caricatore e M2 indica il secondo cari- 


catore. nn è un numero da 01 a 10 che identifica la locazione del minidisco 


nel caricatore. Specificare M1 equivale a specificare M1.01; specificare M2 
equivale a specifica M2.01. 


Esempio 


Creazione di #WSULIB su disco e copia del supporto WSU da minidisco. 
WSU LOAD 


PROCEDURA WSUSAVE 


La procedura WSUSAVE copia il supporto WSU su minidisco. Viene copiato il 
supporto WSU dalle librerie #7WSULIB e #LIBRARY. E’ possibile usare la Pro- 
cedura WSULOAD per caricare il supporto WSU dal minidisco di riserva. Il minidisco desti- 


nato a contenere la copia salvata deve avere come ID di volume PPUTIL e deve 
essere disposto nell’alimentatore S1, 


La procedura WSUSAVE non ha parametri. 


Esempio 


Copia dei supporto WSU su minidisco. 


WSUSAVE 


Eden 







WSUTXCR 


PROCEDURA WSUTXCR 


La procedura WSUTXCR crea un file di transazioni WSU da un file diretto, a 
indice o sequenziale non-WSU su disco. La procedura può anche essere usata 
per ricreare un file di transazioni WSU da un altro file di transazioni WSU. Per 
ulteriori informazioni sul WSU e su questa procedura, vedere il manuale WSU 
Guide. 








nome file d'immissione,|F1|,|CR 
Il| |RC |ia sessione 


KS] 


[numero di record |, runghezza record | , | WSU s 
Ds nome programma 


- 





nome libreria Sl | 
libreria corrente 52 | 
s3 | 

Ml.nn | 

M2.nn| 

| 








nome file di immissione specifica il file di immissione. 


F1 specifica che il file di immissione è un file su disco. Se non viene immesso 
alcun parametro, sì presume F1. 


11 specifica che il file di immissione è un file su minidisco. Se il nome file di 
immissione specificato corrisponde al nome di un file su disco esistente, 
viene visualizzato un messaggio. 


CR specifica che deve essere creato un file di transazioni WSU dal file di immis- 
sione non-WSU. Se non viene immesso alcun parametro, si presume CR. 


RC specifica che deve esseré ricreato un file di transazioni WSU dal file di im- 
missione WSU. 


RS specifica che deve essere|creato un file di transazioni WSU da un file di tran- 
sazioni WSU. 


ALL specifica che l'ID di sessione in ciascun record del file di immissione deve 
essere copiato invariato Sul file di emissione, Se non viene specificato alcun 
parametro, si presume ALL. 


id sessione specifica l'ID di Sessione che deve essere inserito su ciascun record di 
emissione. 





s [ALL |, nome file d'emissione, 
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nome file di emissione specifica il file che la procedura WSUTXCR deve creare, 
Se esiste un file su disco con il nome specificato, viene visualizzato un mes- 
saggio di errore. 


numero di record specifica il numero di record che devono essere riservati per il 
file di emissione. Può essere specificato qualsiasi numero da 1 a 8.000.000. 
Se non è specificato il numero di record, viene usato il numero di record 
effettivamente presente nel file di immissione. 


lunghezza record specifica la lunghezza dei record nel file di emissione, Se viene 
specificato CR, la tunghezza di record deve tener conto di una coda di 13 
byte al termine di ciascun record nel file di transazioni WSU. Se non viene 
immessa alcuna lunghezza dì record, viene usata la lunghezza di record del 
file di immissione. 


WSU specifica che il programma WSU generato non è ancora disponibile e che 
tutti i record non vuoti nel file di emissione, devono essere identificati come 
record di dettaglio. Se non viene specificato alcun parametro, si presume 
WSU. 


nome programma specifica il nome del programma WSU generato che deve usare 
il file di transazione ricostruito o di recente creato. 


nome libreria specifica la libreria che contiene il programma WSU. Se non viene 
immesso alcun parametro, si presume la libreria corrente. 


S1, S$2 o S3 specifica l'alimentatore del minidisco contenente il primo minidisco 
da elaborare. Se non è specificato alcun parametro, si presume S1. 


M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidi- 
sco da elaborare. M1 indica il primo caricatore e M2 indica il secondo cari- 
Catore. nn è un numero da 01 a 10 che identifica la locazione del minidisco 
nel caricatore. Specificare M1 equivale a specificare M1.01; specificare M2 
equivale a specificare M2,01. 


Esempio 


Questo esempio mostra come creare un file di transazioni WSU denominato 
WSUTRAN da un file su disco sequenziale denominato TRANSACT. Deve 
usare il file un programma WSU denominato WSUPROG nella libreria PROGLIB. 
Il file deve avere 200 record e una lunghezza di record di 300. 


WSUTXCR TRANSACT,,CR,,WSUTRAN,200,300,WSUPROG,PROGLIB 


PROCEDURA WSUTXEX 


La procedura WSUTXEX copia i record da un file di transazioni WSU o da un 
file non-WSU a indice, diretto o sequenziale, 1 record copiati possano essere li- 





hà stati, inseriti in un file su disco o inseriti in un file su minidisco, Per ulteriori 
informazioni sul WSU e su questa procedura, vedere il manuale WSU Guide. 
Per copiare record da un file e listarli o copiarli su un file su disco: 
WSUTXEX nome file d'immissione,|F1|,|RS|,/ALL s 
IN ia sessione 
OUTPTX 
nome file d'emissione, [numero di record | ì [1unghezza record] 
Per copiare recorda da un file, aggiungerli a o copiarli su un file su minidisco: 
WSUTXEX nome file a'imnissione,[F1|, RS |, [ALL. , 
7 RC la sessione 


CR 


nome file d'emissione, [numero di record| , [Lunghezza record| È 


id volume,|giorni di validitàl ,|] Sl 
di S2 
ADD $3 

Ml.nn 


M2.nn 





nome file di immissione specifica il nome del file di immissione. 


F1 specifica che il file di immissione è un file su disco. Se non viene immesso 
alcun parametro, si presume F1. 


{11 specifica che il file di immissione è un file su minidisco. Se il nome file di im- 
missione specificato corrisponde al nome di un file su disco, viene visualizza- 
to un messaggio. 
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RS specifica che i record di dettaglio e di testata devono essere copiati in ordine 
logico da un file di transazioni WSU. | record non leggibili (logicamente can- 
cellati), non devono essere copiati. Se non viene immesso alcun parametro, si 
presume RS, 


RC specifica che i record di testata e di dettaglio devono essere copiati in ordine 
fisico da un file di transazioni WSU o da un file non-WSU. 


CR specifica che tutti i record che contengono almeno una posizione diversa dal- 
lo spazio in bianco, devono essere copiati in ordine fisico da un file non- 
WSU. 


ALL specifica che devono essere copiati tutti i record di dettaglio e di testata. 


id sessione specifica che devono essere copiati soltanto i record di dettaglio e di 
testata che hanno YID di sessione specificato. 


OUTPTX specifica che i record copiati devono essere listati sull'unità di lista cor- 
rente di sistema. E’ possibile usare il comando STATUS SESSION per deter- 
minare l’unità di lista corrente del sistema. Se non viene immesso alcun para- 
metro, si presume OUTPTX. 


nome file di emissione specifica il file che la procedura WSUTXEX deve creare. 
Se esiste un file su disco con il nome specificato, viene visualizzato un mes- 
saggio di errore. 


numero di record specifica il numero di record che devono essere allocati per il 
file di emissione. E’ possibile specificare qualsiasi numero da 1 a 8.000.000. 
Se non è specificato il numero di record, viene usato il numero di record 
effettivamente presenti nel file di immissione. 


lunghezza record specifica la lunghezza dei record per il file di emissione. Se non 
è specificata la lunghezza di record, si presume la lunghezza dei record del 
file di immissione. 


id volume specifica l'ID di volume di un minidisco destinato a ricevere i record 
copiati. 


giorni di validità specifica che deve essere creato un nuovo file su minidisco e il 
numero di giorni durante i quali il file deve essere conservato. E’ possibile 
specificare qualsiasi numero decimale da 0 a 999. Se non viene immesso al- 
cun periodo di validità, si presume 1 giorno. 


ADD specifica che a un file su minidisco esistente si devono aggiungere i record 
copiati. 


S1, S$2 o $S3 specifica l'alimentatore del minidisco contenente il primo minidisco 
da elaborare. Se non è specificato alcun parametro, si presume S1. 


M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidi- 
sco da elaborare. M1 indica il primo caricatore e M2 indica il secondo cari- 
catore. nn è un numero da 01 a 10 che identifica la locazione del minidisco 
nel caricatore. Specificare M1 equivale a specificare M1.01; specificare M2 
equivale a specificare M2.01, 


Esempio 


Questo esempio mostra come copiare record da un file su disco di transazioni 
WSU denominato WSUTRAN e listare quei record sull'unità di lista di sistema. 


WSUTXEX WSUTRAN 
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WSUTKRV 


PROCEDURA WSUTXRV 


La procedura WSUTXRV ricupera un file di transazioni WSU che provoca pro- 
blemi quando viene eseguito un programma WSU. Per ulteriori informazioni sul 
WSU e su questa procedura, vedere il manuale WSU Guide. 


nome file,{RECOVER , [home programma |, nome libreria 


RECLAIM libreria corrente 
REMOVE 


nome file specifica il file da ricuperare. 


RECOVER specifica che i record di controllo devono essere ripristinati in modo 
che non ci sia alcuna segnalazione per indicare che i record sono stati can- 
cellati. 


RECLAIM specifica che i record parzialmente inseriti devono essere rigenerati e 
cioè che gli operatori devono essere in grado di usare i record, 


REMOVE specifica che i record parzialmente inseriti e i record cancellati devono 
essere rimossi dal file. 


nome programma specifica il programma WSU generato che deve essere usato per 
determinare quali record sono corretti o non corretti. 


nome libreria specifica la libreria che contiene il programma WSU. Se non viene 
immesso alcun parametro, si presume la libreria corrente. Se viene specificato 
un nome di libreria, deve essere specificato il nome del programma. 


Esempio 
Questo esempio mostra come rigenerare un file su disco dì transazioni WSU deno- 


minato WSUTRAN. Il programma che usa il file è denominato WSUPROG e si 
trova nella libreria denominata PROGLIB. 


WSUTXRV WSUTRAN,RECLAIM,WSUPROG,PROGLIB 
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PROCEDURA XREST | | ela) a Egna 


| La procedura XREST dell’IBM Slstema/34 non è supportata. 





PROCEDURA XSAVE 
La procedura XSAVE dell'IBM Sistema/34 non è supportata. 
| 
"ge 


Capitolo 5. Specifiche OCL 


Questo capitolo descrive le specifiche di linguaggio di controllo operativo (OCL) 
dei Sistema/36. Le specifiche OCL consentono di eseguire programmi e di con- 
trollare come il sistema esegue i programmi stessi. Per ciascuna specifica vengono 
fornite le seguenti informazioni: 


e La funzione della specifica. 


e La posizione della specifica in relazione alle altre specifiche nella procedura e 
le circostanze nelle quali è necessaria. 


e Il formato di sintassi della specifica. Per una descrizione delle regole usate 
per descrivere i formati di sintassi, vedere Convenzioni usate per descrivere i 
formati di sintassi. 


e Descrizione dei parametri della specifica. 


e Unoo più esempi del modo in cui usare la specifica. 


POSIZIONE DELLE SPECIFICHE OCL 


Le specifiche OCL costituiscono un lavoro o un passo di lavoro. La fine di un 
passo di lavoro è indicata da una specifica OCL RUN o (se il programma che vie- 
ne eseguito legge le specifiche di controllo di programmi di utilità) da una specifi- 
ca di controllo di programma di utilità END. Talune specifiche OCL possono es- 
sere inserite soltanto tra specifiche OCL LOAD e RUN per un passo di lavoro; ne 
è un esempio la specifica OCL COMM. Altre specifiche OCL possono essere di- 
sposte ovunque tra le altre specifiche OCL. 


L'esempio che segue mostra le specifiche OCL che costituiscono due passi di la- 
voro, ll primo passo di lavoro (che esegue il programma ACTREC) termina con la 
prima specifica OCL RUN; il secondo passo di lavoro (che esegue il programma 
di utilità $COPY) termina con la specifica di controllo det programma di utilità 
END. 


* Primo passo di lavoro 
// LOAD ACTREC 

// FILE NAME-DATA 

// RUN 

* 

* Secondo passo di lavoro 
// LOAD $COPY 

// FILE NAME-COPYIN, LABEI-DATA, DISP-SHR 
// RUN 

// COPYFILE OUTPUT-CHAR 
// END 
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TIPI DI INFORMAZIONI CONTENUTE NELLE SPECIFICHE OCL 


Le specifiche OCL contengono due tipi di informazioni: un identificatore e uno 
o più parametri. L’identificatore distingue una specifica OCL da un'altra; un pa- 
rametro fornisce informazioni al SSP. La forma generale di una specifica OCL è: 


// identificare parametro l, parametro 2, . . . 


Identificatori 


Ogni specifica OCL salvo INCLUDE richiede un identificatore. Tutte le specifiche 
OCL iniziano con // seguite da 1 o più spazi in bianco. Per esempio, nella speci- 
fica: 


// LOAD PROGRAM 


l'identificatore della specifica OCL è LOAD. Il programma da caricare è denomi- 
nato PROGRAM. 


La specifica di fine dati: 
/* 


non richiede //. 


Parametri 


I parametri sono posizionali o a parola chiave. Un parametro posizionale è un va- 
lore. Un parametro a parola chiave è una parola chiave seguita da un valore. Nella 
seguente specifica, PROG1 e MYLIB sono parametri posizionali e rappresentano 
il nome di un programma da caricare e la libreria che contiene il programma: 


// LOAD PROG1,MYLIB 


I parametri posizionali devono essere immessi nell'ordine indicato nei formati di 
sintassi. 


Nella specifica seguente, NAME-COPYIN e LABEL-FILE1, sono parametri a pa- 
rola chiave: 


// FILE NAME-COPYIN,UNIT-F1,LABEL-FILEl 


Un parametro a parola chiave contiene una parola chiave (NAME e LABEL sono 
le parole chiave nella precedente specifica OCL) che distingue il parametro degli 
altri, esattamente come gli identificatori distinguono una specifica OCL da un'al- 
tra. Oltre ad una parola chiave, un parametro a parola chiave, solitamente contie- 
ne un valore (COPYIN e FILE1 sono valori nella precedente specifica OCL). 


I parametri e la parola chiave possono essere immessi in qualsiasi ordine, non ne- 
cessariamente nell'ordine indicato nei formati di sintassi. 


= 


rn, 


| PARAMETRI DI PROCEDURA 


Un parametro può essere una qualsiasi combinazione di caratteri. Punti interrogati- 
vi (?), virgole (,), apici (’), barre (/), trattini (-), segni di maggiorazione di (>), segni 
di uguale (=), segni più {+), e spazi in bianco, dovranno essere usati con cautela 
perchè essi hanno dei particolari significati nelle procedure. 


Se un parametro deve contenere spazi intermedi o virgole (,), esso deve iniziare e 
finire tra apici. Un tale parametro (racchiuso tra apici) è considerato una stringa di 
caratteri, 

Tutti i dati compresi tra apici vengono elaborati come un solo parametro. Gli apici 
all’inizio e alla fine non vengono elaborati come facenti parte del parametro. La lun- 
ghezza del parametro è impostata secondo il numero dei caratteri tra apici. L'esem- 
pio che segue mostra la stringa di caratteri /une 77, 1985 come primo parametro 
di PROCA. La iunghezza del parametro è 13. 


PROCA “June 17, 1985” 
Se nella stringa deve essere incluso un apice, questo deve essere indicato due volte. 
“one o'clock” 
La lunghezza della stringa di caratteri è equivalente al numero di caratteri definiti 
tra gli apici, eccetto i due apici della stringa contati come uno. L'esempio che segue 
mostra come immettere la stringa di caratteri /fs one o’clock. La lunghezza della 
stringa dei caratteri è 16. 
“Its one o”clock” 
Se un parametro non inizia con un apice, qualsiasi altro apice trovato nel parametro 
viene considerato un dato non stringa di caratteri. L'esempio che segue mostra pa- 


rametri con apici come dati. Il primo parametro è Mary's ed il secondo è o ‘c/ock. 


PROCA Mary's, o'‘clock 
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REGOLE GENERALI DI CODIFICA OCL 


Vedere Convenzioni usate per descrivere i formati di sintassi per una descrizione 
del modo in cui immettere le procedure, i comandi e le specifiche OCL. Le rego- 
le ulteriori per le specifiche OCL, sono: 


Le // devono essere immesse nelle posizioni 1 e 2. 


Una o più posizioni tra // e l’identificatore della specifica devono essere la- 
sciate in bianco. Per esempio: 


// LOAD 
oppure 
// "LOAD 


Una o più posizioni tra l’identificatore della specifica e il primo parametro 
devono essere lasciate in bianco. Per esempio: 


// LOAD PROG1,MYLIB 


oppure 


// LOAD PROG1 ,MYLIB 


Se occorre comprendere più di un parametro, usare una virgola per separare 
i parametri. Non sono ammessi spazi in bianco all’interno o tra i parametri. 
Tutto ciò che segue il primo spazio in bianco dopo un parametro, è consi- 
derato un commento (vedere Commenti). 


Se si immettono parametri a parola chiave, disporre la parola chiave per pri- 
ma e usare il trattino di divisione sillabica (—) per separare la parola chiave 
dal valore. 


N » 


Se non è specificato un valore con un parametro a. parola chiave, il parame- 
tro è ignorato. Per esempio: 


// FILE NAME-FILEA,DATE- ,UNIT-F1 


Quando questa specifica viene elaborata, il parametro a parola chiave DATE 
viene ignorato. 
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Continuazione delle specifiche OCL 


L'espressione di una singola specifica su due o più righe è detta Continuazione. 
Qualsiasi specifica OCL che contiene parametri a parola chiave può essere conti- 
nuata. : 


Le regole per usare la continuazione sono: 


e Iniziare ciascuna nuova riga con // nelle posizioni 1 e 2. 


e Lasciare uno o più spazi in bianco tra // e il primo parametro sulla riga. 


e Inserire una virgola dopo l’ultimo parametro in ogni riga, salvo l’ultima. La 
virgola, seguita da uno spazio in bianco, dice al SSP che la specifica conti- 
nua alla riga successiva. 


Nell'esempio che segue di una specifica OCL FILE continuata sulle righe succes- 
sive, sono usate cinque righe per esprimere la specifica stessa. 


// FILE NAME-INPUT, 


// LABEL-FILF1, 
// RECORDS-250, 
// RETAIN-J 


La riga è interpretata da SSP come: 
// FILE NAME-INPUT,LABEL-FILEl ,RECORDS-250,RETAIN-J 


Vedere Continuazione delle righe di una procedura per un altro modo per con- 
tinuare le specifiche OCL. Questo metodo usa un segno più (+) nell'ultima posi- 
zione diversa dallo spazio in bianco nella riga per indicare che la riga continua, 
L'esempio precedente potrebbe in questo caso essere stato scritto come segue: 


// FILE NAME-INPUT,+ 
LABEL-FILE1,+ 
RECORDS-250,+ 
RETAIN-J 


E sarebbe stato interpretato come: 

// FILE NAME-INPUT,LABEL-FILEl sRECORDS-250 ,RETAIN-J 
Notare che il sistema ha bisogno di più tempo per leggere ie specifiche continuate. 
Se un record termina con un carattere di traslazione a destra immediatamente 
prima dell'espressione di continuazione ed il primo carattere diverso dallo spazio 


in bianco del successivo record è un carattere di traslazione a sinistra, entrambi 
i caratteri di trastazione verranno rimossi. 


pESa 


Commenti 


I commenti possono essere usati in una procedura per spiegare lo scopo delle spe- 
cifiche. | commenti in una procedura compaiono quando la procedura viene lista- 
ta su una stampatrice o su una unità video. | commenti non compaiono invece 
quando la procedura viene eseguita, | commenti possono contenere qualsiasi com- 
binazione di caratteri. Comunque, il simbolo di continuazione (segno +) è ricono- 
sciuto in un commento se la specifica non ha un * in colonna 1. i commenti posso- 
no essere inclusi nei punti seguenti; 


Dopo l'asterisco (*) nella specifica di commento. Per esempio: 
* THIS IS AN EXAMPLE OF A COMMENT STATEMENT 


Il commento qui è THIS IS AN EXAMPLE OF A COMMENT 
STATEMENT. 


Dopo l’ultimo parametro in una specifica. Lasciare uno o più spazi in bianco 
tra l'ultimo parametro e il commento. Per esempio: 


// LOAD $COPY LOAD THE COPY UTILITY 


In questo esempio il commento è LOAD THE COPY UTILITY. Unaltro 
esempio: 


// RUN RUN THE PROGRAM 


Il commento qui è RUN THE PROGRAM; — la specifica RUN non ha para- 
metri. 


Dopo ia virgola che segue l’ultimo parametro in una riga continuata. Per 
esempio: 


//] FILE NAME-INPUT, FILE STATEMENT FOR 


1] LABEL-FILE1, INPUT FILE 
// RECORDS-250, 
(74 RETAIN-J 


In questo esempio, le prime due righe della specifica FILE contengono com- 
menti, 
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Dopo il nome di procedura in una specifica OCL INCLUDE, se la specifica 
ha dei parametri ma nessuno di questi viene specificato, Lasciare uno spazio 
in bianco dopo il nome di procedura, immettere una virgola, lasciare uno 
spazio in bianco dopo la virgola ed immettere il commento. Per esempio: 


PAYROLL , RUN PAYROLL PROCEDURE 


oppure 


// PAYROLL , RUN PAYROLL PROCEDURE 
oppure 
// INCLUDE PAYROLL , RUN PAYROLL PROCEDURE 


Il commento in questa specifica è RUN PAYROLL PROCEDURE. 


Note: 


1. 


Le espressioni di sostituzione contenute in una specifica di commento saranno va- 
lutate ad eccezione delle specifiche di commento precedente da un asterisco (*). 


Una specifica OCL INCLUDE che richiama una procedura per terminali richiedenti 
multipli (MRT) o una procedura che trasmette dati (non parametri), non può conte- 
nere un commento. 


SPECIFICA OCL ABEND 


La specifica OCL ABEND indica l’unità da usare per una stampa della funzione 
nel caso in cui si verifichi un errore di programma, Un errore di programma è 
solitamente provocato da un difetto nel programma; il SSP interrompe it pro- 
gramma ed emette un messaggio di errore, Una stampa della funzione fa sì che 
venga stampata o copiata su un disco o su un minidisco l’area di memoria del 
programma, l} file su disco 0 su minidisco viene quindi elaborato. dalla procedura 
DUMP o APAR. 


La periferica di emissione indicata dalla specifica ABEND rimane valida fino a 
che il lavoro termina o fino a che non viene elaborata un'altra specifica ABEND. 


Se non viene indicata alcuna specifica OCL ABEND, l'emissione viene copiata su 
un file su disco. 


La specifica OCL ABEND viene ignorata per la copia del contenuto della memo- 
ria della procedura SETDUMP e per le copie del contenuto della memoria pro- 
dotte quando viene premuto il tasto Stop MSP sul pannello di controllo del sistema 
(la funzione Alter/Display). 


Posizione: la specifica OCL ABEND può essere disposta ovunque fra le specifiche 
OCL. 


// ABEND OUTPUT- | DISK 


DISKETTE 
FRINTER 





OUTPUT specifica dove devono essere inviati i dati di stampa della funzione. 


DISK specifica che deve essere creato un nuovo file su disco e che tutte le 
aree di memoria della funzione errata devono essere copiate nel file su disco. 
Il file può quindi essere elaborato dalla procedura DUMP o APAR. | file di 
copia sul disco del contenuto delia memoria sono denominati #DUMP.nn, 
dove nn è un numero che va da 00 a 99. 


DISKETTE specifica che deve essere creato un nuovo file su minidisco. Al- 
l'operatore è richiesto di inserire un minidisco nel modulo a minidischi per 
copiare nel file su minidisco tutte le aree di memoria della funzione difetto- 


sa. Il file può quindi essere elaborato dalla procedura DUMP o APAR. 


PRINTER specifica che tutte le aree di memoria della funzione difettosa de- 
vono essere stampate sulla stampatrice di sessione dell'operatore. E’ possibile 
usare il comando STATUS SESSION per determinare la stampatrice di ses- 
sione. 


TAPE specifica che viene creato un nuovo file su nastro. All’operatore viene richie- 
sto di specificare l’unità nastro su cui montare la bobina e tutte le aree di memoria 
della funzione in errore vengono copiate sul file su nastro. Il file può allora essere 
elaborato dalla procedura APAR, DFA o DUMP. 


514.1 


Esempio 


Per far sì che le aree di memoria del programma PAYROLL vengano scritte su 
minidisco (nel caso in cui si verifichi un errore di programma), è possibile proce- 
dere come segue: 


// ABEN OUTPUT-DISKETTE 
// LOAD PAYROLL 

// FILE NAME-EMPLOYES 
// RUN 


514.2 


SPECIFICA OCL ALLOCATE 


La specifica OCL ALLOCATE fa sì che il modulo a minidischi venga allocato ad 
un lavoro e cioè, dopo che la specifica OCL ALLOCATE viene elaborata, nessuna 
altra procedura può usare il modulo a minidischi. Ciò consente all'operatore di 
mantenere il controllo del modulo durante un lavoro che usa il modulo stesso pa- 
recchie volte, senza cederne il controllo ad un altro lavoro nel sistema. Dopo l’e- 
laborazione della specifica OCL ALLOCATE e l'allocazione dell'unità a minidi- 
schi al lavoro, si accende la spia Minidisco in Uso. 


Questa specifica consente inoltre di scrivere o di leggere una serie di file su mini- 
disco in modo che ciascun passo di lavoro che usa il modulo a minidischi possa 
iniziare dalla posizione usata da un precedente passo di lavoro. 


Il modulo a minidischi rimane allocato al lavoro fino a che il lavoro termina o fi- 
no a che non viene elaborata nel lavoro una specifica OCL DEALLOC, 


Nota: La specifica OCL ALLOCATE non è ammessa in una procedura per termi- 
nali richiedenti multipli (MRT). 3 


Posizione: La specifica OCL ALLOCATE può essere disposta ovunque tra le spe- 
cifiche OCL. 









// ALLOCATE UNIT-|I1l ,AUTO- sel , CONTINUE- f NO ra 
TI NO YES NO 
T2 - 





UNIT specifica se vengono allocati un modulo a minidischi, un'unità nastro speci- 
fica o entrambe le unità nastro. 


| T1 specifica che viene allocata l’unità a minidischi. 
T1 specifica che viene allocata l’unità nastro 1. 
T2 specifica che viene aliocata l’unità nastro 2. 


"T1,T2' specifica che vengono allocate entrambe le unità nastro 1 e 2. Se una 
delle due unità non è disponibile, non viene allocata neppure l’altra. Questa 
opzione deve essere racchiusa tra apici e separata da una virgola. 


TC specifica che viene allocata l’unità nastro a cassetta. 


AUTO indica se il modulo a minidischi deve automaticamente avanzare al succes- 
sivo alimentatore. Questo parametro esclude temporaneamente i parametri 
AUTO e NOAUTO nelle procedure e il parametro AUTO della specifica OCL 
FILE, 


Esempi di procedure che usano le specifiche OCL FILE sono FROMLIBR e 
TOLIBR; esempi di procedure che non usano le specifiche OCL FILE sono 
CATALOG e INIT. Vedere la Specifica OCL FILE (per i file su minidisco) 
e la Specifica OCL FILE (per i file su nastro) per un elenco delle procedure 
dei programmi di utilità di sistema che usano la specifica OCL FILE per i 
file su minidisco e su nastro. 


Il parametro AUTO è ignorato per i sistemi che non dispongono di un modu- 
lo a minidischi a caricatore. 
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YES per le unità a minidischi a caricatore, specifica che quando deve essere 
elaborato un altro minidisco, il successivo ‘alimentatore deve essere fatto 
avanzare automaticamente. Per le unità a nastro, YES specifica che se viene 
raggiunta la fine del nastro mentre si sta elaborando un file, deve essere usata 
automaticamente la successiva unità nastro. Se quell’unità nastro non può es- 
sere allocata, per il nastro successivo viene usata l’unità nastro originale. 


NO per le unità a minidischi a caricatore specifica che quando deve essere 
elaborato un altro minidisco, non deve essere fatto avanzare automaticamen- 
te il successivo alimentatore. Per le unità nastro, NO specifica che non deve 
essere fatta avanzare automaticamente la successiva unità nastro quando deve 
essere elaborato un altro nastro. 


CONTINUE specifica se i passi di lavoro che usano un modulo a minidischi ela- 


boreranno una serie sequenziale di file su minidisco; cioè se ogni passo di la- 
voro che usa il moduio a minidischi continuerà dalla posizione finale del mi- 
nidisco del passo precedente. Se viene usata la specifica ALLOCATE ma vie- 
ne omesso il parametro CONTINUE, si presume CONTINUE-NO. li parame- 
tro CONTINUE è ignorato se il sistema non ha un modulo a minidischi a ca- 
ricatore, 


NO indica che deve essere usata la posizione di minidisco indicata nella pro- 
cedura o nella specifica OCL FILE. 


YES specifica che deve essere creata o letta una serie sequenziale di file su 
minidisco. 


Questo metodo di funzionamento rimane in atto fintantoché il modulo a mi- 
nidischi è usato per l'immissione o l'emissione ed è indicata la stessa locazio- 
ne in ciascuna procedura o specifica OCL FILE su minidisco o espressione 
di controllo procedura (VOLID-,?VOLID?, o DATAI1) che usa il mo- 
dulo stesso, Ogniqualvolta cambia una di queste condizioni, il SSP presume 
che venga elaborata una nuova serie di file su minidisco e deve essere usata la 
posizione specificata su quella procedura o sulla specifica OCL FILE. 


Quando vengono creati i file su minidisco, soltanto il primo minidisco può 
contenere file attivi. Quando i file su minidisco vengono letti e non è possibi- 
le trovare un file nella posizione corrente, il SSP presume che venga elabora- 
ta una nuova serie di file su minidisco e che deve essere usata la posizione 
indicata su quella procedura o sulla specifica OCL FILE. 


Se. è specificato CONTINUE-YES, deve essere specificato anche AUTO-YES. 


Nota: CONTINUE non si applica se viene allocata un'unità nastro; viene 
emesso un messaggio di errore. 


WAIT indica se la procedura deve attendere che il modulo a minidischi venga di- 


sponibile, Se viene usata la specifica ALLOCATE ma viene omesso il para 
metro WAIT, si presume WAIT-YES. 


YES specifica che se il modulo a minidischi è già allocato o viene usato, la 
procedura deve attendere che il modulo a minidischi venga disponibile. Se il 
modulo è allocato a un programma interrotto o in attesa o viene usato da un 
programma con l’attributo di programma sempre residente in memoria, oppu- 
re da un lavoro che ha allocato il modulo a minidischi usando ia specifica 
OCL ALLOCATE, viene visualizzato un messaggio e l'operatore può ritentare 
l'operazione di allocazione oppure cancellare il lavoro. 


Zen 


Ego 


NO specifica che se il modulo a minidischi è già allocato o viene usato, la 
procedura deve continuare. Può essere usata l’espressione di sostituzione 
?CD? per vedere se il modulo a minidischi era allocato alla procedura, Se il 
modulo non era allocato, dall'espressione ?CD? viene ritornato il valore 2032 
o 2033. Vedere Espressione ?CD? (codice di ritorno) per ulteriori informa- - 
zioni sui valori sostituiti da queste espressioni. 


Esempio 1 


Per creare una serie di file su minidisco contenenti librerie, è possibile procedere 
come segue. | minidischi destinati a contenere le librerie sono negli alimentatori 
S1 e S2 e hanno ID di volume VOL001, 


// ALLOCATE UNIT-I1l,CONTINUE-YES,AUTO-YES 
SAVELIBR MYLIB, ,VOLOO1 

SAVELIBR YOURLIB,,VOLOO1 

SAVELIBR OURLIB,,VOLOO1 

SAVELIBR PAYLIB,,VOLOO1 


oppure 


// ALLOCATE UNIT-I1,CONTINUE-YES,AUTO-YES 
// LOAD $MAINT 

// FILE NAME-MYLIB,UNIT-I1,PACK-VOLOOl 

// FILE NAME-YOURLIB,UNIT-Il,PACK-VOLOO1 

// FILE NAME-OURLIB,UNIT-I1,PACK-VOLOO1 

// FILE NAME-PAYLIB,UNIT-I1,PACK-VOLOO1 

//] RUN 

// COPYLIBR FROM-MYLIB,TO-DISK,FILE-MYLIB 
// COPYLIBR FROM-YOURLIB,TO-DISK,FILE-YOURLIB 
// COPYLIBR FROM-OURLIB,TO-DISK,FILE-OURLIB 
/] COPYLIBR FROM-PAYLIB,TO-DISK,FILE-PAYLIB 
// END 





Esempio 2 


Per allocare il modulo a minidischi ad un lavoro e non attendere che il modulo a 
minidischi venga disponibile, è possibile procedere come segue. 1 minidischi desti 
nati a contenere i file sono nell’'alimentatore di caricatore M1 ed hanno come ID 
di volume VOL002. 


// ALLOCATE UNIT-I1,CONTINUE-YES,WAIT-NO,AUTO-YES 

// IFF ?CD?=2032 IFF ?2CD?=2033 GOTO OK 

// PAUSE ‘Modulo a minidischi allocato a un altro lavoro. 
// CANCEL 

// TAG OK 

SAVE ALL,,,VOLO02,ALL,Ml 

SAVELIBR LIBR1,,VOLO02,M1 

SAVELIBR LIBR2,,VOLO02,M1 
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Esempio 3 


Per allocare l'unità nastro 1 ad un lavoro senza attendere che l’unità diventi di- 
sponibile, si può usare quanto segue. ll nastro destinato a contenere i file si trova 
sull'unità nastro 1 ed ha un ID di volume di VOL002. 


// ALLOCATE UNIT-T1,WAIT-NO,AUTO-YES 

// IFF ?CD?=2035 IFF ?CD?=2036 GOTO OK 

// PAUSE 'Unità nastro 1 allocata ad altro lavoro! 
// CANCEL i 

// TAG OK 

SAVE ALL, , ,VOLOO2,ALL,T1 

SAVELIBR LIBR1,,VOL002,,,T1 

SAVELIBR LIBR2,,VOL002,,,T1 


// ATTR 


SPECIFICA OCL ATTR 


La specifica OCL ATTR: 


Indica se un operatore può cancellare un lavoro; e cioè se un operatore può 
terminare un lavoro prima che questo sia stato completato normalmente, 


Indica se può essere avviato un altro lavoro su una unità video mentre un la- 
voro viene interrotto. 


Modifica il numero massimo di terminali richiedenti per un programma MRT, 


Modifica l'indicatore di programma sempre residente in memoria per un pro- 
gramma. 


Assegna una priorità ad un lavoro o ad un passo di lavoro. 


Rilascia l’unità video richiedente dal successivo passo di lavoro quando il suc- 
cessivo passo di lavoro inizia l'esecuzione. 


Posizione: La specifica OCL ATTR può comparire ovunque tra le specifiche OCL 
salvo che tra LOAD e RUN, 


i ce, [rmaxnne | Lt). 


,PRIORITY-{ HIGH ,RELEASE-{ 10 } 


NO NO 


NO 


YES YES 
MEDIUM 
NO 


LOW 





CANCEL specifica se un lavoro può essere cancellato da un operatore premendo 


il tasto ATTEN e scegliendo l'opzione 2 o 3 dallo schermo d’interrogazione. 
Questo parametro interessa soltanto ie opzioni che sono visualizzate sullo 
schermo d'interrogazione. Cioè l'operatore può premere il tasto ATTEN e 
interrompere temporaneamente il lavoro ma le opzioni 2 o 3 per cancellare 
il lavoro non sono disponibili. Il lavoro può sempre essere cancellato usando 
il comando di controllo CANCEL sulla console di sistema. 


Questa condizione rimane in atto fino a che non viene modificata da un'altra 
specifica ATTR o fine a che il lavoro non termina, 


YES specifica che compariranno le opzioni 2 e 3 dello schermo di interroga- 
zione e che l'operatore può cancellare il lavoro scegliendo l'opzione 2 o l’op- 
zione 3. 


NO specifica che non compariranno le opzioni 2 e 3 dello schermo d'interro- 
gazione e che il lavoro non può essere cancellato usando fo schermo di inter- 
rogazione. 
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INQUIRY indica se può essere avviato un altro lavoro da un operatore che preme 


il tasto ATTEN e sceglie l'opzione 1 dallo schermo di interrogazione. Questo 
parametro interessa soltanto le opzioni che sono visualizzate sullo schermo di 
interrogazione; l'operatore può cioè premere il tasto ATTEN ed interrompere 
temporaneamente il lavoro ma non è disponibile l'opzione 1 per richiedere lo 
schermo dei comandi. Questa condizione rimane in effetto fino a che non 
viene modificata da un'altra specifica ATTR o fino a che il lavoro non ter- 
mina, 


Se viene specificato il parametro INQUIRY, viene ignorato l'indicatore di 
programma non interrompibile (questo indicatore può essere attivato dall’edi- 
tore di moduli oggetto a sovrapposizione o da un linguaggio di programma- 
zione tipo RPG). 


YES specifica che comparirà l'opzione 1 dello schermo di interrogazione e 
che l'operatore può avviare un altro lavoro scegliendo l'opzione 1 e immet- 
tendo il comando o il numero di menù richiesto per avviare un altro lavoro. 


NO specifica che l'opzione 1 dello schermo di interrogazione non comparirà, 
impedendo così all'operatore di avviare un altro lavoro. 


MRTMAX specifica il numero di terminali richiedenti multipli (unità video o ses- 


sioni SSP-ICF) che possono essere collegati al programma eseguito nel succes- 
sivo passo di lavoro. Soltanto una specifica ATTR in un passo di lavoro può 
indicare il parametro MRTMAX, 


nnn modifica il valore MRTMAX indicato sulla specifica COMPILE quando il 
programma è stato compilato. nnn non può superare il valore MRTMAX in- 
dicato nella specifica COMPILE o nella specifica di descrizione file RPG II 
MRTMAX è ammesso soltanto se nella specifica COMPILE era indicato un va- 
lore MRTMAX di uno o più. Gli zeri di testa non devono essere immessi. 


NEP specifica se il programma è sempre residente in memoria (NEP). NEP è defi- 


nito come un programma a lunga esecuzione, Altri lavori non possono usare 
le risorse di sistema, salvo i file condivisi e il file di stampa differita, che sono 


allocate a un NEP. 
YES specifica che il programma è un NEP. 
NO specifica che il programma non è un NEP, 


Occorre specificare NEP-YES per il programma che usa uno o più risorse di 
sistema che non possono essere condivise (ad esempio un file su disco che 
non può essere condiviso) per un periodo di tempo più lungo di quello che 
l'operatore dell'unità video deve lasciar trascorrere perchè il SSP avvii un pro- 
gramma. Se l'operatore tenta di eseguire un programma che usa una risorsa 
di sistema non condivisibile e utilizzata da un NEP, il SSP non attende che la 
risorsa diventi disponibile ma emette un messaggio indicante che il program- 
ma richiesto non può essere avviato in quanto un NEP sta usando la risorsa 
richiesta. L'operatore può quindi cancellare il lavoro o ritentare l'allocazione 
delle risorse. 


Se l'operatore tenta di eseguire un lavoro che usa una risorsa di sistema non 
attualmente condivisibile che viene usata da un programma di lunga esecuzio- 
ne per il quale non è stato specificato NEP-YES, il SSP attende che la risorsa 
diventi disponibile. Mentre il SSP è in attesa, l'operatore all'unità video può 
usare il modo interrogazione (premendo il tasto ATTEN) per cancellare il la- 
voro o per eseguire altri lavori. 


Se viene specificato il parametro NEP, il valore indicato quando il program- 
ma è stato compilato viene ignorato. Soltanto una specifica ATTR in un pas- 
so di lavoro può indicare il parametro NEP. È 


Esistono le seguenti speciali considerazioni per i lavori eseguiti dalla coda di 
lavori e per i programmi ‘a terminali richiedenti multipli (MRT): 


e Tutti i programmi eseguiti dalla coda di lavori sono eseguiti come NEP 
a meno che nan sia specificato NEP-NO sulla specifica OCL ATTR. 


e Per un programma MRT, se non è specificato NEP-YES sulla specifica 
OCL ATTR e se non è stato specificato NEP quando il programma è 
stato compilato, altri programmi non attenderanno le risorse non condi- 
vise usate dal programma MRT. In ogni caso quando il programma MRT 
rilascia la sua ultima unità video richiedente, il programma passa all’ela- 
borazione di fine lavoro. 


e Se viene specificato NEP-YES per un programma MRT, altri programmi 
non attenderanno le risorse non condivise usate dal programma MRT. Il 
programma MRT non termina quando rilascia la sua ultima unità video 
richiedente. Per contro, il programma MRT attenderà fino a che non è 
richiesto da un’altra unità video. Normalmente un programma MRT in 
cui é specificato NEP-YES non termina fino a che l'operatore di sistema 
non immette il comando di controllo STOP SYSTEM e tutte le unità vi- 
deo che usano il programma MRT non sono rilasciate. (L'operatore di 
sistema può terminare il programma MRT in qualsiasi momento usando 
il comando CANCEL). 


PRIORITY specifica la priorità di elaborazione per un lavoro o passo di lavoro. 

° Il sistema assegna le risorse di sistema in ordine di priorità decrescente. L'or- 
dine di priorità è HIGH o YES, MEDIUM, NO e LOW. Per esempio, se viene 
specificato PRIORITY-MEDIUM, le risorse del sistema sono assegnate al la- 
voro o al passo di lavoro dopo che sono state assegnate ad un lavoro o ad un 
passo di lavoro a priorità più elevata (YES o HIGH} ma prima che vengano 
assegnate a qualsiasi lavoro o passo di lavoro a priorità inferiore (NO o LOW). 
PRIORITY-YES e PRIORITY-HIGH sono equivalenti, Il parametro PRIORITY 
può essere presente più di una volta in un lavoro; questo parametro ha effet- 
to appena viene incontrato. 


Se i’operatore immette il comando PRTY specificando HIGH, MEDIUM, 
LOW, YES o NO, prima di presentare un lavoro, qualsiasi parametro PRIO- 
RITY sulla specifica ATTR viene ignorato. Se l'operatore di sistema immette 
il comando PRTY specificando HIGH, MEDIUM, LOW, YES o NO dopo che 
il lavoro è avviato, qualsiasi parametro PRIORITY successivo sulla specifica 
ATTAR viene ignorato. 


Nessuna priorità di lavoro può essere modificata automaticamente dal siste- 
ma. } lavori con priorità HIGH, MEDIUM e LOW non cambiano automatica- 
mente priorità. Vedere it manuale Concepts and Programmer's Guide per ul- 
teriori informazioni sulla priorità dei lavori. 
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RELEASE specifica se l'unità video rimane allocata al successivo passo di lavoro. 
Il parametro RELEASE è ignorato per i lavori nella coda dei lavori. Se non 
è specificato RELEASE, si presume RELEASE-NO. 


NO specifica che il successivo passo di lavoro non è rilasciato e che l’unità 
video rimane allocata al passo di lavoro. 


YES rilascia l’unità video quando il successivo passo di lavoro inizia l’esecu- 
zione. Se quel passo di lavoro è l’ultimo o il solo passo in una procedura, 
sull'unità video compare lo schermo dei comandi e l’operatore può iniziare 
un altro lavoro, Se quel passo di lavoro non è l’ultimo in una procedura, vie- 
ne rilasciato soltanto quel passo di lavoro. Il passo rilasciato viene eseguito 
contemporaneamente ai passi successivi della stessa procedura. L'unità video 
richiedente rimane allocata ai passi che seguono quello rilasciato. Se viene 
specificato RELEASE-YES vanno presi in considerazione i seguenti punti: 


e | file di lavoro esistenti non possono essere trasmessi al passo rilasciato. 
Per informazioni sui file di lavoro, vedere la Specifica OCL FILE (per 
i file su disco). 


e | file di stampa continuata non possono essere trasmessi al passo rilascia- 
to. Per ulteriori informazioni sui file di stampa continuati, vedere la Spe- 
cifica OCL PRINTER. 


e Solo quei file cui si fa riferimento da parte delle specifiche OCL FILE 
tra le successive coppie di specifiche OCL LOAD e RUN vengono tra- 
smessi al passo di lavoro rilasciato. Tutte le altre specifiche OCL FILE, 
comprese quelle in cui è stato specificato JOB-YES, continueranno ad 
essere di proprietà del lavoro originale e possono essere usate nei passi 
di lavoro successivi. Ciò significa che un passo di lavoro rilasciato da 
una specifica OCL ATTR non può disporre di file specificati al di fuori 


delle specifiche OCL LOAD e RUN di quel passo di lavoro. 


e | file di lavoro creati dal passo rilasciato, sono trattati come file tempo- 
ranei; cioè tali file non possono essere usati dai passi successivi in questa 
procedura, 


e ll parametro RELEASE-YES è ignorato se le specifiche OCL per il passo 
di lavoro contengono una specifica WORKSTN che indica REOD-YES 
per l’unità video richiedente. 


e | messaggi di sistema emessi dal passo rilasciato sono visualizzati sulla 
console di sistema e non sull'unità video che ha rilasciato il passo di la- 
voro. 


e Un passo rilasciato usa una copia degli indicatori di stato UPSI per l’uni- 
tà video richiedente e l’area dati locale dell'unità video esistenti quando 
il passo rilasciato era stato avviato. Se il passo rilasciato cambia l’area 
dati locale dell'unità video o gli indicatori di stato, le modifiche riman- 
gono in effetto soltanto durante il passo di lavoro. Le modifiche non so- 
no viste dai passi di lavoro successivi nella procedura o dai successivi la- 
vori sottoposti dall'unità video. 


e Se viene specificato RELEASE-YES per un passo di lavoro che esegue 
un programma per terminali richiedenti multipli (MRT).che è anche 
definito come un programma sempre residente in memoria (NEP), il pro- 
gramma MRT viene avviato ma non ha unità video. Il programma MRT 
attende quindi la successiva unità video richiedente. 
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Esempio 1 
Per impedire che l'operatore termini il programma PAYROLL scegliendo l’op- 
Dea zione 2 o 3 dallo schermo di interrogazione, si potrebbe procedere come segue: 
// ATTR CANCEL-NO 
// LOAD PAYROLL 
// FILE NAME-EMPLOYES 
// PRINTER NAME-PRINT,DEVICE-P2,FORMSNO-CHCK,ALTGN-YES 


// RUN 


Esempio 2 


Per assegnare una priorità di elaborazione elevata ad un lavoro rilasciato dall'unità 
video, si potrebbe procedere come segue: 


// ATTR PRIORITY-HIGH,RELEASE-YES 
// LOAD PROGI 
// RUN 
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SPECIFICA OCL COMM 


La specifica OCL COMM è usata dai programmi BSC non interattivi per: 
e Assegnare un numero di linea ad un programma che usa le comunicazioni, 


e Assegnare un elenco telefonico ad un programma che usa il dispositivo di 
chiamata automatica. 


e Indicare se deve essere ripristinato l'elenco telefonico per il programma che 
usa il dispositivo di chiamata automatica. 


e Specificare la libreria su cui ricercare la lista telefonica. 


Posizione: La specifica OCL COMM deve essere disposta tra le specifiche OCL 
LOAD e RUN del programma, 


YES 


// COMM LINE-| |.FHONB-nome nenbro ci } 





LINE specifica il numero della linea dì comunicazioni da associare al programma 
di comunicazioni. Se non viene specificato un numero di linea, si presume 1. 


PHONE specifica il nome del membro dell'elenco telefonico (creato dalla proce- 
dura DEFINEPN o DEFINX21), che deve essere usato dal dispositivo di 
chiamata automatica. 


RESTORE specifica se l’elenco telefonico usato da un precedente passo nel lavo- 
ro, deve essere ripristinato alla condizione originale; cioè se l'elenco telefoni- 
co sarà predisposto per indicare che non sono state tentate chiamate. 


NO specifica che l'elenco telefonico specificato dal parametro PHONE e usa- 
to nel precedente passo di lavoro non deve essere ripristinato nel suo stato 
originale. Notare che in questo passo di lavoro viene usato lo stesso elenco 
telefonico del precedente passo (posto che i nomi corrispondano); e cioè non 
viene effettuato alcun controllo per determinare se il precedente elenco tele- 
fonico e l'elenco telefonico specificato provengono da librerie diverse. Se non 
viene specificato alcun parametro, si presume NO. 


YES specifica che l'elenco telefonico specificato dal parametro PHONE deve 
essere ripristinato alla condizione originale. Il SSP per prima cosa cerca 
l'elenco telefonico nella libreria corrente quindi nefla libreria di sistema 
(#LIBRARY). 


LIBRERIA specifica la libreria da ricercare per la lista telefonica. Se la lista telefonica 
non viene trovata sulla libreria specificata, allora la ricerca si sposta sulla libreria di siste- 
ma (#LIBRARY). Se questo parametro non viene specificato, il sistema prima ricerca 
sulla libreria corrente, poi su quella di sistema. Se la lista telefonica non viene trovata 
su nessuna delle due librerie, viene inviato un messaggio. 


Esempio 


Questo esempio mostra come assegnare ad un programma un numero di linea di 
comunicazioni e un elenco telefonico. Il programma verrà eseguito per ciascun 
numero nell'elenco telefonico. 


// TAG CALL 

//] LOAD CALLPROG 

// COMM LINE-1,PHONE-PHONELST,RESTORE-NO 

// RUN 

// IFF LISTDONE-PHONELST GOTO CALL 

* Se l'elenco non è stato completato, 

* eseguire il programma per chiamare il prossimo numero 
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SPECIFICA OCL COMPILE 


La specifica OCL COMPILE fornisce le informazioni richieste dal SSP quando 

viene compilato un membro origine di libreria. La specifica OCL COMPILE ese- 

gue quanto segue: 

e Identifica il membro origine di libreria che contiene il programma origine da 
compilare. Un programma origine è una raccolta di specifiche, ad esempio 
specifiche RPG Il, che possono essere compilate in un programma eseguibile. 


e Identifica la libreria che contiene il programma origine. 


e identifica la libreria che conterrà il membro oggetto compilato. Il membro 
oggetto può quindi essere caricato ed eseguito usando le specifiche OCL 
LOAD e RUN. 


e Specifica, se il programma è del tipo a terminali richiedenti multipli (MRT), 
il numero massimo di unità video richiedenti che possono essere collegate al 
programma. 


x 


e Specifica se il programma è un programma sempre residente in memoria 
(NEP). 


®e Specifica il dizionario dati che deve essere usato dal programma. 
e Specifica se il compilatore deve usare strutture overlay residenti in memoria. 


Posizione: La specifica OCL COMPILE deve essere disposta tra le specifiche OCL 
LOAD e RUN del passo di lavoro che compila il programma origine. Se il pro- 
gramma origine è nella procedura o nel flusso di lavori della tastiera, la specifica 
OCL COMPILE può essere omessa, 


// COMPILE SOURCE-nome |,INLIB-fnome libreria 
libreria corrente 


libreria corrente 0 NO 





,OUTLIB- nome libreria \ sù da 4) 
lb 


È DATADCT-nome dizionario dati| 





SOURCE specifica il nome del membro origine che contiene il programma origine 
da compilare. 


INLIB specifica il nome della libreria che contiene il programma origine. Se viene 
specificato INLIB, la ricerca viene effettuata soltanto in quella libreria. Se 
non viene specificato INLIB, si presume ia libreria corrente. 


OUTLIB specifica il nome della libreria che conterrà il membro oggetto compila- 
to. Se non è specificato OUTLIB, si presume la libreria corrente. Il nome del 


membro oggetto è specificato nel programma origine oppure è lo stesso del 
programma origine. : 
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MRTMAX identifica il programma come programma per terminali richiedenti 
multipli (MRT), 


nnn specifica il numero massimo di unità video richiedenti che possono es- 
sere collegate al programma (gli zeri di testa non devono essere immessi). 


Se nnn è 0 oppure se non è specificato MRTMAX, il programma oggetto 
non è un programma MRT. Se viene specificato MRTMAX, il numero mas- 
simo di terminali richiedenti può essere modificato da una specifica ATTR 
quando il programma oggetto viene eseguito. 


NEP specifica se il programma è del tipo sempre residente in memoria (NEP). 
NEP è definito come un programma a lunga esecuzione. Qualsiasi risorsa di 
sistema salvo i file condivisi e il file di stampa differita che sono allocati a 
un NEP, non è disponibile per altri lavori. 


YES specifica che il programma è un NEP. 
NO specifica che il programma non è un NEP. 


L'indicatore NEP può essere modificato da una specifica ATTR quando il 
programma viene eseguito. 


Esistono le seguenti considerazioni speciali per i lavoro eseguiti dalla coda 
di lavori e per i programmi a terminali richiedenti multipli (MRT): 


e Tutti i programmi eseguiti dalla coda di lavori sono eseguiti come NEP, 
a meno che non sia indicato NEP-NO sulla specifica OCL ATTR. 


e Se non è indicato NEP-YES per un programma MRT sulla specifica OCL 
ATTAR e se non è indicato NEP-YES sulla specifica OCL COMPILE, gli 
altri programmi non attenderanno le risorse non condivise usate dal pro- 
gramma MRT. In ogni caso quando il programma MRT rilascia la sua 
ultima unità video richiedente, il programma va all'elaborazione di fine 
lavoro. 


e Se viene specificato NEP-YES per il programma MRT, altri programmi 
non attenderanno le risorse non condivise usate dal programma MRT. li 
programma MRT non termina quando rilascia la sua ultima unità video 
richiedente. Per contro, il programma MRT attende fino a che non è 
richiesto da un'altra unità video, Normalmente un programma MRT in 
cui è specificato NEP-YES non termina se non dopo che l'operatore di 
sistema ha immesso il comando STOPSYSTEM e tutti i terminali richie- 
denti sono rilasciati. (L'operatore di sistema può terminare il lavoro in 
qualsiasi momento usando il comando CANCEL). 


Per informazioni su NEP, SRT e MRT, vedere il manuale Concepts and Pro- 
grammer's Guide. 


DATADCT specifica il dizionario dati che contiene le definizioni di formato che devono 
essere utilizzate dal programma. 


MRO specifica se il compilatore deve usare strutture overlay residenti in memoria. 


Se non viene specificato MRO, ie strutture overlay residenti in memoria non 
vengono usate. 


YES specifica che il compilatore userà strutture overlay residenti in memoria 


NO specifica che il compilatore non userà strutture overlay residenti in memoria. 
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Esempio 


Deve essere compilato il membro origine denominato PROG3 nella libreria deno- 
minata MYLIB. Il membro oggetto compilato verrà inserito nella libreria di siste- 


ma. Il programma PROG3 viene eseguito come NEP. DE 
// COMPILE SOURCE-PROG3.INLIB-MYLIB,OUTLIB-#LIBRARY,NEP-YES 
da 
TN 
ia 


SPECIFICA OCL DATE 


La specifica OCL DATE immessa ovunque tra le specifiche OCL eccetto tra le 
specifiche LOAD e RUN, modifica la data di sessione. (Una sessione inizia quan- 
do l'operatore si collega e, normalmente, termina quando l'operatore immette il 
comando OFF). Se non viene usata una specifica DATE o una procedura DATE 
per stabilire una data di sessione, come data di sessione viene usata quella specifi- 
cata dal sistema durante il caricamento del programma iniziale. 


Una specifica OCL DATE che viene immessa tra le specifiche OCL LOAD e RUN, 
indica la data di programma (nota anche come data del passo di lavoro). Quando 
termina il passo di lavoro, la data viene riportata alla ‘data di sessione. Se non è 
immessa una specifica DATE oppure se la procedura DATE non viene eseguita 
tra una specifica OCL LOAD e RUN, viene usata quella della sessione come data 
del programma. Se ci sono due o più specifiche DATE tra una specifica RUN e 
una specifica LOAD, viene usata l’ultima specifica DATE. ” 


Note: 


1. La data del programma viene usata per determinare per quanto tempo un file 
su minidisco deve essere valido e viene riportata sull’emissione stampata. La 
data del programma viene anche usata come data di creazione di qualsiasi file 
su disco o su minidisco creato dal programma. 

2. Se un lavoro viene inserito nella coda di lavori, al lavoro viene assegnata la 
data di programma valida quanto il lavoro è stato inserito nella coda. 

3. Se sono ie 2400, la data del sistema viene automaticamente aggiornata ma la 
data di sessione e la data del programma non sono aggiornate per le sessioni 
o i programmi attivi. 
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// DATE 


Posizione: Una specifica DATA può comparire ovunque tra le specifiche OCL. 


mmegaa 
ggrmaa 
aammgg 





La data indicata sulla specifica DATE deve essere nel formato corrente della data 
di sessione. Quest'ultima può essere in uno qualsiasi dei tre formati: mese-giorno- 
anno (mmggaa), giorno-mese-anno (ggmmaa) o anno-mese-giorno (aammgg). Può 
essere usato il comando STATUS per determinare il formato corrente della data 
di sessione e la procedura SET per modificarne il formato corrente. 


Il mese, il giorno e l’anno devono essere rappresentati ciascuno da un numero di 
due cifre, ma gli zeri di testa nel mese e nel giorno, possono essere omessi quan- 
do vengono usati i segni di punteggiatura. Nella forma con punteggiatura, può es- 
sere usato qualsiasi carattere salvo le virgole (,), gli apici (‘), i numeri e gli spazi 
vuoti come segno di punteggiatura. Per contro non possono essere usati i punti in- 
terrogativi (?). 


La data può essere immessa con o senza segni di punteggiatura. Per esempio 24 
Luglio 1983 può essere specificato in uno dei modi seguenti: 


Formato della data 


7-24-83 mm-gg-aa 





24-7-83 gg-mm-aa 





83/7/24 aa/mm/gg 
072483 mmggaa 











240783 ggmmaa 


Una data di tutti zeri (000000), non è valida. 





AT 


Esempio 1 
La specifica DATE per 1 Luglio 1983: 


// DATE 070183 


oppure: 


// DATE 7-1-85 


Esempio 2 


Per specificare una data di programma (data del passo di lavoro) per il program- 
ma PAYROLL, è possibile inserire ta specifica DATE tra le specifiche LOAD e 
RUN per la procedura PAYROLL. Quando il programma PAYROLL termina, la 
data di sessione viene usata per il programma PAYPRNT. 


Il programma PAYROLL legge il file EMPLOYES e calcola gli assegni. Negli asse- 
gni è inciusa la data. Specificando la data di programma usando la specifica DA- 
TE, è possibile eseguire il programma prima della data effettiva (indicata dal para- 
metro 1, l'espressione ?1R?). Il programma PAYPRNT non usa la data, 


La procedura PAYROLL esemplificativa contiene le seguenti istruzioni: 


* PAYROLL Procedura 

* Calcolo degli assegni usando la data specificata 
// LOAD PAYROLL 

// DATE ?1R? 

// FILE NAME-EMPLOYES,DISP-OLD 

// FILE NAME-CHECKS sRETAIN-J, BLOCKS-30 


// RUN 
* 


* Stampa degli assegni sui moduli previsti (CHCK) 

* Consentito l'allineamento degli assegni sulla stampatrice 

// LOAD PAYPRNT 

// FILE NAME-CHECKS,RETAIN-J 

// PRINTER NAME-PRINT, SPOOL-NO, LINES-25, FORMSNO-CHCK, 
ALIGN-YES,DEVICE-P3 

// RUN 


Per eseguire la procedura e specificare una data di 7-1-84 per PAYROLL, occor- 
rerebbe immettere: 


PAYROLL 7-1-8h 
e la specifica DATE verrebbe elaborata come: 


// DATE 7-1-8% 
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SPECIFICA OCL DEALLOC 


La specifica OCL DEALLOC libera il modulo a minidischi dopo che una specifica 
OCL ALLOCATE ha allocato il modulo stesso. Ciò consente ad altri lavori sul si- 
stema di usare il modulo a minidischi, 


Posizione: la specifica DEALLOC può essere disposta ovunque tra le specifiche 
OCL. 


// DEALLOC UNIT-(I1 
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JRE 


T2 
T1,T2'! 





UNIT specifica quale unità deve essere liberata in modo che altri programmi la 
possano usare. 


11 specifica che deve essere liberata l’unità a minidischi. 
T1 specifica che deve essere liberata l’unità a nastri 1. 
T2 specifica che deve essere liberata l’unità a nastri 2. 


"T1,T2’ specifica che devono essere liberate entrambe le unità nastro 1 e 2. 
Questa opzione deve essere racchiusa tra apici e separata da una virgola. 


TC specifica che il nastro è un nastro a cassetta. 


Esempio 


In questo esempio il modulo a minidischi è allocato per tre procedure e quindi 
viene liberato prima che il programma PROG1 venga caricato, in modo che altri 
lavori possano usare il modulo. 


// ALLOCATE UNIT=-I1,WAIT-YES 
SAVE FILE1,,,VOLOOO1 

SAVE FILE2,,,VOLOOO1 

SAVE FILE3,,,VOLOOO1 

// DEALLOC UNIT-I1l 

// LOAD PROGI 

// RUN 


SPECIFICA OCL DEBUG 


La specifica OCL DEBUG indica se devono essere listate le espressioni di control- 
lo procedura e le specifiche OCL delle procedure man mano che vengono valuta- 
te e se le procedure devono interrompersi dopo ciascun passo di lavoro. Ciò con- 
sente di seguire il percorso logico delle procedure. 


Posizione: La specifica OCL DEBUG può essere disposta ovunque tra le specifi 
che OCL. Se la specifica OCL DEBUG viene immessa dalla tastiera, i parametri 
rimangono in effetto fino a che non viene immessa un'altra specifica OCL 
DEBUG o fino a che non ci si scollega dal sistema (cioè quando viene immesso il 
comando OFF). : 


Se viene indicata la specifica OCL DEBUG in una procedura, essa rimane in effet- 
to fino a che non viene elaborata un’altra specifica OCL DEBUG o fino a che la 
procedura termina. Quando la procedura termina, hanno effetto i parametri 
(eventuali) immessi dalla tastiera. 


YES YES 


// DEBUG PROC- fo | a } 





PROC specifica se le espressioni di controllo procedura e Je specifiche OCL devo- 
no essere listate man mano che vengono valutate. Le informazioni sono lista- 
te sull'unità di lista del sistema. E’ possibile determinare qual'è l'unità di li- 
sta attuale del sistema immettendo il comando STATUS SESSION, La proce- 
dura SYSLIST imposta l’unità di lista del sistema. 


Se l'unità di lista del sistema è l’unità video, e la lista del passo di lavoro che 
viene presentata non riempie lo schermo, non viene visualizzato alcun mes- 
saggio per indicare la fine dei dati di lista di sistema prima che venga presen- 
tato il successivo passo di lavoro. E’ possibile che un'altra emissione di lista 
di sistema generata dalla procedura possa essere combinata con le espressioni 
di controllo procedura e con le specifiche OCL. 


NO specifica che la lista non deve venir generata, Se non viene specificato 
PROC, viene presunto NO. 


YES specifica che la lista deve essere generata. 


Nota: L'emissione andrà all'unità di lista di sistema che era in effetto quando 
si è incontrata la specifica OCL DEBUG. Queli‘unità di lista di sistema rima- 
ne in effetto fino a che non è disattivata la ricerca e la correzione degli erro- 
ri; cioè qualsiasi procedura SYSLIST o qualsiasi specifica OCL o qualsiasi 
specifica OCL PRINTER avente il parametro NAME-$SYSLIST verrà ignora- 
ta se è attivata la ricerca e la correzione degli errori. ° 


STEPHALT specifica se la procedura deve essere interrotta (e cioè temporanea- 
mente fermata) dopo ciascun passo di lavoro nella procedura. 


NO specifica che la procedura deve essere eseguita normalmente. Se non è in- 
dicato STEPHALT, si presume NO. 
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YES specifica che deve essere visualizzato un messaggio dopo. che è stato 
completato ciascun passo di lavoro nella procedura. ll messaggio indica il 
nome della procedura di primo livello (se si sta eseguendo la procedura) e il 
nome del programma che è stato eseguito e l'operatore può scegliere un'op- 
zione per continuare o cancellare la procedura 


Esempio 
Questo esempio mostra come usare la specifica DEBUG per osservare le espres- 
sioni di controllo procedura durante una procedura campione denominata 
SAMPLE. 


La procedura SAMPLE contiene le seguenti specifiche: 


* SAMPLE Procedura 


* Parametro l: Nome file (obbligatorio, richiesto se omesso) 


* Parametro 2: Data di creazione del file (facoltativo) 
// * *'PROCEDURA SAMPLE IN ESECUZIONE! 

// LOAD $COPY 

// FILE NAME-COPYIN,LABEL-? 1R?, 

// TIFF 222= DATE-?22, 

// UNIT-F1 

// RUN 

// COPYFILE OUTPUT-CHAR 

// END 


Queste specifiche vengono usate per eseguire la procedura e produrre la lista di ri- 
cerca e correzione degli errori: 


// DEBUG PROC-YES 
SAMPLE FILEl 


Quanto segue mostra l'immissione prodotta dalla specifica DEBUG: 


SAMPLE FILEl 
* SAMPLE Procedura 


* Parametro l: Nome file (obbligatorio, richiesto se omesso) 


* Parametro 2: Data di creazione del file (facoltativo) 
//%  *PROCEDURA SAMPLE IN ESECUZIONE! 
// LOAD $COPY 
// FILE NAME-COPYIN,LABEL-?1R?, 

FILE NAME-COPYING,LABEL-FILEl, 
// IFF ?2?= DATE-?2?, 

IFF = DATE-?2?, 

/} UNIT-F1l 
// RUN 
// COPYFILE OUTPUT-CHAR 
// END 


SPECIFICA OCL EVOKE 


La specifica OCL EVOKE può essere usata per avviare una procedura (cioè la 
procedura viene richiamata). Quando viene richiamata una procedura, essa inizia 
l'esecuzione come lavoro separato e il controllo ritorna immediatamente alla pro- 
cedura richiamante. E’ così possibile avere parecchie procedure che vengono ese- 
guite contemporaneamente come risultato di parecchie specifiche OCL EVOKE. 
La specifica OCL EVOKE può essere più utile per i lavori che non richiedono 
immissione o risposta da parte dell'operatore o per i lavori la cui emissione non è 
richiesta da un successivo passo di lavoro. 


La priorità di un lavoro richiamato è la stessa del lavoro che ha emesso il richia- 
mo. 


1 messaggi emessi dal lavoro richiamato sono visualizzati sulla console di sistema 
e non sull'unità video {se è diversa dalla console di sistema) che ha emesso l’ope- 
razione di richiamo. La procedura richiamata usa una copia degli indicatori di sta- 
to UPSI e dell’area dati-iocale esistente sull'unità video richiedente. Se la procedu- 
ra richiamata modifica gli indicatori di stato UPSI o l’area dati locale, le modifi- 
che sono valide soltanto per il lavoro richiamato; le modifiche non sono rilevate 
da successivi lavoro eseguiti o richiamati sull'unità video richiedente. 


Se non è indicata alcuna specifica OCL REGION nella procedura contenente la 
specifica OCL EVOKE, ia procedura richiamata usa la dimensione di regione di 
sessione specificata durante la configurazione del sistema o dalla procedura SET. 
Se viene indicata una specifica OCL REGION nella procedura contenente la spe- 
cifica OCL EVOKE, la procedura richiamata usa la dimensione di regione indi- 
cata nella specifica OCL REGION, 


| Una procedura MRT non può essere richiamata dalla specifica OCL EVOKE. 


Non si devono usare troppe specifiche OCL EVOKE in quanto ciò potrebbe ral- 
lentare il funzionamento del sistema. 


Posizione: La specifica EVOKE può essere disposta ovunque tra le specifiche 
OCL salvo che tra le specifiche OCL LOAD e RUN. 





// EVOKE nome procedura [none librerie] paraml,param2... 


s *ALL 
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nome procedura specifica la procedura da richiamare, 


nome libreria specifica la libreria in cui cercare la procedura, Se la procedura non 


viene trovata nella libreria specificata, viene esaminata la libreria di sistema 
{#LIBRARY). Se non è indicato alcun nome di libreria, la ricerca viene ef- 
fettuata nella libreria corrente per prima e quindi nella libreria di sistema 
(#LIBRARY). 


param1,param2, ... specifica i parametri per la procedura. | parametri non sono 


ammessi se la procedura è del tipo MRT oppure se è stato specificato 
PDATA-YES quando è stato creato il membro di procedura. | parametri 
possono essere richiesti o meno in relazione alla procedura alla quale sono 
trasmessi. 


Un parametro può essere qualsiasi combinazione di caratteri salvo le virgole 
o gli spazi in bianco. | punti interrogativi (?), gli apici (’), le barrette (/), i 
segni di uguale (=), i segni di maggiore di (>) e i trattini di divisione silla- 
bica (-), devono essere usati con cautela in quanto hanno significati speciali 
nell’ambito delle procedure. Il numero totale di caratteri per un parametro 
non deve superare 128. E’ possibile passare un massimo di 64 parametri se- 
parati da virgole con una sola specifica EVOKE. 


Quando si immettono i parametri, è possibile battere fino a 512 caratteri. 
Per esempio è possibile battere 32 parametri da 16 caratteri o 64 parametri 
da 8 caratteri. In ogni caso, la lunghezza totale combinata di tutti i para- 
metri-non può superare i 1024 caratteri; questa lunghezza può essere otte- 
nuta usando espressioni di sostituzione e l’area dati locale. Vedere Continua- 
zione delle righe di una procedura per informazioni sul modo in cui conti- 
nuare le righe di immissione per ottenere caratteri in numero maggiore di 
120. 


Vedere Specifica OCL INCLUDE per ulteriori informazioni sul modo in cui 
è possibile immettere i parametri. | dati del programma non possono essere 


. specificati. 


*ALL specifica che tutti i parametri devono essere passati dal livello di proce- 


dura corrente alla procedura che viene richiamata. *ALL può essere specifi- 
cato soltanto nell'ambito di una procedura. Se viene specificato *ALL come 
solo parametro e questo viene immesso dalla tastiera o selezionato da un’op- 
zione di menù, viene visualizzato un messaggio di errore. Se viene specificato 
*ALL come uno dei parametri, viene trattato come un singolo parametro. 


Nell'esempio che segue, ie specifiche OCL comprendono una specifica OCL 
EVOKE che passa i parametri alla procedura PROC1. Quando PROC1 viene richiamata, 
inizia l'esecuzione e il controllo ritorna immediatamente: alla procedura richia- 
mante. Pertanto entrambe le procedure sono in esecuzione contemporanea- 
mente e indipendentemente. 


// EVOKE PROCL 
// LOAD PAYROLL 
// RUN 


TA 


Vara 


SPECIFICA OCL FILE (PER 1 FILE SU DISCO) 


La specifica OCL FILE per i file su disco, fornisce all'SSP informazioni relative 
ai file su disco. Il SSP usa queste informazioni per leggere record dal e scrivere 
record sul file su disco. 


Per informazioni sui concetti di file su disco del Sistema/36, vedere il manuale 
Learning about Your Computer e il manuale Concepts and Programmer's Guide. 


Posizione: è indispensabile una specifica OCL FILE per ciascun file su disco che 
ciascun programma crea o usa, La specifica OCL FILE può essere disposta ovun- 
que tra le specifiche OCL. 


Se la specifica FILE è disposta prima di una specifica LOAD, l’SSP tenta immediata- 
mente di fare dell’utente il proprietario del file su disco (leggere la parola chiave JOB 
per informazioni sulla durata dell’acquisizione del file). L'acquisizione di un file su 
disco in questo modo stabilisce soltanto il livello di proprietà del file (e cioè quale 
programma può usare il file), sia condiviso che vecchio. Il file non è effettivamente 
creato o usato fino a che non è allocato, aperto e usato da un programma (alcuni 
linguaggi di programmazione combinano in una sola operazione i passi di allocazio- 
ne e di apertura). Ciò consente di determinare, prima di avviare una serie di passi 
di lavoro, se tutti i file richiesti dai passi di lavoro sono disponibili. Inoltre, il file vie- 
ne trattato come se il programma abbia l'indicatore di programma sempre residente 
in memoria (NEP) (vedere Specifica OCL ATTR per indicazioni sull’indicatore NEP). 
Ciò evita che altri lavori attendano il file se questo non può essere condiviso. 
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Se la specifica OCL FILE è disposta tra le specifiche OCL LOAD e RUN per un 
passo di lavoro, il file è acquisito quando la specifica OCL RUN viene elaborata, 





/} FILE NAME-nome file |.unrr-1 | ;sLABEL-identificazione file| 
,RECORDS-record| |,LOCATION-|A1 O ,RETAIN- {TT 
,BLOCKS-blocchi A2 i i 

A3 Ss 
‘AL 1 
L numero blocco | 
,PATE- (mmggaa ) | |.DISP-{ SHR [por Li svAIT- (tes) 
gemma a. SHRMM NO NO 
aammgg SHRMR 
SHRRM 
SHRRR 
NEW 
OLD 
A 
.EXTEND-valore | dai ,sBYPASS-JNO DUPKEYS- j NO 
ai 1, YES YES 
|.DBLOCK-recorà | Pi indice | de 


siii } 
NO ampiezza massima memoria indice 


NAME specifica il nome che il programma usa per fare riferimento al file. Il no- 
me può essere qualsiasi combinazione di caratteri (numerici, alfabetici e spe- 
ciali) salvo le virgole (,), gli apici (’), e gli spazi in bianco. | punti interroga- 
tivi (?), le barrette (/), i segni di uguale (=), i segni di maggiore (>) e i trat- 
tini di divisione sillabica (-), devono essere usati con cautela in quanto hanno 
significati speciali nell’ambito delle procedure. il primo carattere del nome 
file deve essere alfabetico (da A a Z, #, $ o @). Il numero dei caratteri in 
un nome file non deve superare 8. 


UNIT-F1 specifica che il file è sul disco. Questo parametro non deve essere speci- 


ficato per un file su disco in quanto F1 è il valore assunto per difetto per il 
parametro UNIT, 


en 


LABEL specifica il nome effettivo o identificazione col quale il file è individuato 
sul disco. Occorre soltanto specificare il parametro LABEL quando il nome 
effettivo del file su disco è diverso dal nome usato nel programma. Se il pa- 
rametro LABEL è omesso da una specifica FILE su disco, viene usato il no- 
me file del parametro NAME. Se un programma non fa riferimento ad un file 
esistente mediante il nome effettivo del file sul disco, deve essere fornito il pa- 
rametro LABEL. 


I nomi file possono essere qualsiasi combinazione di caratteri (numerici, alfa- 
betici e speciali, salvo le virgole (,), gli apici (‘), e gli spazi in bianco. | punti 
interrogativi (?), le barrette (/), i segni di uguale (=), i segni di maggiore di 
(>) e i trattini di divisione sillabica (-), devono essere usati con cautela in 
quanto hanno significati speciali nell'ambito delle procedure. Il primo carat- 
tere del nome file deve essere alfabetico (da A a Z, #, $ o @). Il numero 
dei caratteri in un nome non deve superare 8, 


Il nome potrebbe essere quello di un file che appartiene ad un gruppo di fi- 
le. Se il nome file contiene un punto, significa che il file è un membro di un 
gruppo di file. | caratteri davanti al punto identificano il gruppo di file. Ve- 
dere la Procedura SAVE per informazioni sui gruppi di file. 


RECORDS specifica il numero dei record da riservare per il file. Lo spazio totale 
da riservare viene arrotondato al successivo blocco (un blocco contiene 2560 
byte) tenendo conto di spazio sufficiente per contenere il minimo numero di 
record indicato, L'unità di file su disco più piccola che può essere riservata è 
un blocco. Per esempio se si specificano 10 record da 50 byte (e cioè 500 
byte di spazio per i file), vengono riservati 2560 byte (1 blocco). 


record non può superare il valore di 8.000.000. 


In una specifica FILE OCL può comparire RECORDS o BLOCKS ma non 
entrambi. 


Deve essere usato il parametro RECORDS o BLOCKS per un nuovo file. 


BLOCKS specifica il numero dei blocchi su disco da riservare per il file. Ci sono 
2560 byte in un blocco su disco. 


BLOCKS non può superare il massimo configurato. 


RECORDS o BLOCKS ma non entrambi, possono comparire nella specifica 
OCL FILE. 


Deve essere usato il parametro RECORDS o BLOCKS per un nuovo file, E’ 


possibile usare la procedura CATALOG per determinare il numero dei bloc- 
chi su disco disponibili per il file. 
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LOCATION indica un posizionamento preferito di disco per un nuovo file disco, 


oppure specifica il numero di blocco in cui deve iniziare un nuovo file. A1, 
A2, A3 e A4 indicano le unità disco. A1 indica la prima unità disco; A2 in- 
dica la seconda unità disco; A3 indica la terza unità disco; A4 indica la quar- 
ta unità disco. 


Se non si specifica una locazione preferita e non c'è spazio disponibile sull'unità 
disco specificata, l'SSP, tenta di inserire il file sull'unità disco meno usata. Ciò av- 
viene per equilibrare meglio il carico tra le unità disco. | file e le librerie possono 
abbracciare più unità disco; e cioè un file può iniziare su A1 e continuare su A2. 


A1: se si specifica una posizione preferita sul disco A1 per un sistema con 
più di una unità disco, l’SSP inserisce il file nel primo segmento (indirizzo 


più basso) della memoria disponibile sul disco A1 che è sufficientemente 
ampio per contenere il file. 


Se si specifica A1 o non si specifica LOCATION per un sistema con una 
sola unità disco, il SSP' inserisce il file nel primo segmento (indirizzo più 
basso) della memoria disponibile sufficientemente ampio per contenere il 
file. 


A2: se si specifica A2 per un sistema con più di una unità disco, I’SSP inseri- 
sce il file nell'ultimo segmento (indirizzo più alto) di memoria disponibile 
sull'unità disco A2 che è ampio a sufficienza per contenere il file. 


Se si dispone di una sola unità disco e si specifica A2, si presume l’unità di- 
sco Al. 


A3: se si specifica A3 per un sistema con più di un'unità disco, I’SSP inseri- 
sce il file nell'ultimo segmento (indirizzo più elevato) della memoria disponi- 
bile sull'unità disco A3 che è ampio a sufficienza per contenere il file 


Se si dispone di una sola unità disco e si specifica A3, viene assunta l’unità 
disco A1. 


A4: Se si specifica A4 per un sistema con più di una unità disco, I'SSP inse- 
risce il file nell'ultimo segmento (indirizzo più elevato) della memoria dispo- 
nibile sull'unità disco A4 che è ampio a sufficienza per contenere il file. 


Se si dispone di una sola unità disco e si specifica A4, viene assunta l’unità 
disco A1. 


numero blocco specifica la locazione del file; è possibile indicare fino a 6 
cifre. E’ possibile usare la procedura CATALOG per determinare dove sono 
dislocati sul disco i blocchi di memoria disponibili. E’ possibile usare questo 
parametro per creare un nuovo file in una locazione su disco specificata. 


RETAIN specifica il file come residente (T), di lavoro (4) o temporaneo (S) 


quando viene creato, 


Il parametro RETAIN può essere omesso da una specifica FILE. Se ad un 
file residente esistente viene fatto riferimento da parte di una specifica 
FILE, con RETAIN-T, esso rimane un file residente. 


T specifica un file residente, Un file residente rimane sul disco quando il la- 
voro termina. Se il parametro RETAIN viene omesso dalla specifica FILE 
quando il file viene creato, si presume che il file sia un file residente. L'area 
contenente un file residente diventa disponibile per un altro file soltanto 
sotto una delle seguenti condizioni: 


e E’ fornita una specifica OCL FILE contenente RETAIN-S per modificare 
il file da residente a temporaneo. Se il file è usato ne! programma, il file 
non esiste dopo che il programma termina normalmente. Se il program- 
ma non termina normalmente, i file non verranno modificati in file tem- 


poranei ed esisteranno ancora come file residenti. Se il file non è usato 
dal programma, rimane residente dopo la fine del programma. 


e Un altro file con la stessa identificazione viene caricato nell'area occupa- 
ta dal file residente, modificando i dati o l’organizzazione del file. Deve 
essere specificato il parametro DISP-OLD. 


e La procedura DELETE è usata per cancellare il file. 


Il numero totale di file residenti che possono esistere in qualsiasi momento è 
limitato dal numero massimo di entrate VTOC specificate quando il sistema 
è stato configurato. Può esistere qualsiasi numero di file di lavoro e file tem- 
poranei. ll numero effettivo di file da inserire sul disco dipende dalla dimen- 
sione del disco e dalla dimensione dei file, 


J specifica un file di lavoro. Un file di lavoro, una volta creato, può essere 
usato da tutti i passi di lavoro rimanenti in un lavoro. ll file di lavoro è de- 
finito soltanto entro il lavoro e non esiste dopo che il lavoro termina. Se un 
passo di lavoro viene rilasciato (usando il parametro RELEASE in una speci- 
fica OCL ATTR), oppure esegue un programma a terminali richiedenti multi- 
pli (MRT), quel passo non può usare i file di lavoro definiti da altri passi 
del lavoro. Qualsiasi file di lavoro creato da un passo di lavoro rilasciato o da 
un passo di lavoro che esegue un programma MRT, viene trattato come file 
temporaneo e non può essere usato da altri passi nel lavoro. Due o più lavori 
che usano i file di lavoro con lo stesso nome, possonoessere eseguiti contem- 
poraneamente poichè i file di lavcro sono definiti soltanto nell'ambito dei sin- 
goli lavori. 


Quando viene creato un file specificando RETAIN-J, i passi di lavoro seguen- 
ti possono fare riferimento al file non specificando un parametro RETAIN o 
specificando RETAIN-J o RETAIN-S. Se un passo di lavoro seguente specifi- 
ca RETAIN-J o non specifica RETAIN, il file viene conservato per l’uso suc- 
cessivo da altri passi di lavoro. Per contro, se un passo di lavoro successivo 
specifica RETAIN-S per un file di lavoro esistente, quel file viene rimosso al 
termine di quel passo ‘€ non può essere usato dai passi successivi nel lavoro. 


Se viene creato un file con RETAIN-J, un passo di lavoro successivo può usa- 
re o creare un altro file su disco con la stessa identificazione specificando 
RETAIN-T. Un file su disco residente non può essere elaborato nello stesso 
passo di lavoro con un file di lavoro avente la stessa identificazione. 


Nota: se si verifica un guasto di sistema, il contenuto di un file di lavoro o 
di un nuovo file temporaneo vanno persi. 


S specifica un file temporaneo, Un file temporaneo può essere usato soltanto 
dal passo di lavoro che lo crea e non esiste dopo che il passo di lavoro è ter- 
minato. 
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DATE specifica la data di creazione di un file esistente e può essere usata per as- 


sicurarsi che venga usata l’appropriata versione di un file, Il parametro DATE 
non è ammesso quando viene specificato DISP-NEW. 


Quando viene creato un file su disco, la sua identificazione e la data di crea- 
zione sono scritte sul disco come identificazione. La data del passo di lavoro 
quando il file viene creato è quella usata come data di creazione. Se durante la 
configurazione del sistema sono state specificate date. differenziate per i file, a 
più di un file residente può essere attribuita la stessa identificazione; in ogni 
caso, le date di creazione di questi file devono essere diverse. Per riferirsi ad un 
file di questo tipo, specificarne l'identificazione e la data. Se la data non è spe- 
cificata, viene usato il file avente la data più vecchia. 


La data può essere immessa in uno dei tre formati: mese-giorno-anno 
{mmggaa}, giorno-mese-anno (ggmmaa) o anno-mese-giorno (aammgg). In 
ogni caso il formato scelto deve essere lo stesso della data di sessione. Per 
determinare il formato della data di sessione può essere usato il comando 


STATUS SESSION. 


DISP (disposizione) specifica che il file è nuovo o vecchio o che può essere con- 


diviso da altri lavori che vengono eseguiti sul sistema. Il parametro DISP 
non è ammesso se viene specificato RETAIN-J. Se non viene specificato 
DISP, il sistema determina se un file è nuovo o vecchio in base al fatto 
che il file si trovi o meno nel VTOC del disco. Questo non equivale a assegnare 
NEW o OLD nel parametro DISP. DISP-OLD si deve specificare se si vuole sovrap- 
porre un file. 


SHR specifica che il file esiste già e può essere condiviso da altri program- 
mi che vengono eseguiti sul sistema. Possono essere eseguite sul file le ope- 
razioni di lettura, aggiornamento, canceliazione e aggiunta. SHR equivale a 
specificare SHRMM. 


Una descrizione delle considerazioni di programmazione per la condivisione 
del file nel manuale Concepts and Programmer's Guide. 


SHRMM specifica che il programma che usa il file può modificarlo (e cioè 
i record possono essere letti, aggiornati, cancellati o aggiunti). Altri pro- 
grammi che condividono il file possono a loro volta modificarlo. Specificare 
SHRMM equivale a specificare SHR. 


SHRMAR specifica che soltanto il programma che usa il file può modificarlo 
{cioè i record possono essere letti, aggiornati, cancellati o aggiunti). Altri pro- 
grammi che condividono il file possono soltanto leggere i record dal file. 


SHRRM specifica che il programma che usa il file deve soltanto eseguirvi 
operazioni di lettura (cioè non può essere aggiornato, cancellato o aggiunto 
alcun record). Altri programmi che condividono il file possono modificarlo 
(e cioè possono cancellare, aggiornare, leggere o aggiungere record al file). 


SHRRR specifica che il programma che usa il file deve soltanto eseguirvi 
operazioni di lettura (non è possibile cioè aggiornare, cancellare o aggiungere 
record). Altri programmi che condividono il file possono a loro volta soltan- 
to leggere record dal file. 


NEW specifica che il file è nuovo. Se un file esiste già con la stessa identifi- 
cazione e con la stessa data di creazione del nuovo, viene visualizzato un 
messaggio di errore, Il nuovo file può essere creato usando qualsiasi organiz- 
zazione di file su disco. Il file non può essere condiviso da qualsiasi altro 
programma fino a che il programma che lo ha creato termina. 


OLD specifica che il file esiste già e che non può essere condiviso fino a che 
il programma che lo usa non termina. Se il file non esiste, viene visualizzato 
un messaggio di errore. DISP-OLD consente di elaborare un file esistente co- 
me file di emissione. Quando un file esistente viene sovrapposto (e cioè quando 
il file contiene informazioni totalmente nuove), deve essere specificato DISP-OLD. 
La data di creazione del file sovrapposto viene modificata con la data del passo 
di lavoro, tutti i parametri vengono annullati e devono essere specificati di nuovo 
ad eccezione di RECORD/BLOCKS e LOCATION. 


JOB specifica se il file su disco deve essere acquisito per l'intero lavoro. Se viene 


specificato JOB-NO o se un file non è già acquisito e non è specificato alcun 
parametro JOB, il file sarà acquisito soltanto fino a che il passo di lavoro 
termina. 


YES specifica che il file deve essere acquisito per l’intero lavoro. Per tutto il 
lavoro sarà usato il livello di condivisione specificato dal parametro DISP. 


JOB-YES può essere indicato soltanto su una specifica OCL FILE che si tro- 
va al di fuori della coppia di specifiche OCL LOAD e RUN. 


Se viene specificato JOB-YES, gli altri parametri indicati sono assunti ogni 
volta che lo stesso file viene usato dai programmi nei passi di lavoro succes- 
sivi. Cioè se si usa lo stesso file in un passo di lavoro successivo, non occorre 
indicare un’altra specifica OCL FILE per quel passo di lavoro. 


Se si incontra una successiva specifica OCL FILE con il parametro JOB-YES 
ed ha lo stesso parametro NAME della precedente specifica OCL FILE in cui 
era indicato JOB-YES e il file non è stato ancora creato, tutti i parametri in- 
dicati sulla specifica OCL FILE corrente sostituiranno permanentemente i va- 
lori assunti per difetto originali. Qualsiasi parametro che non è indicato sulla 
specifica OCL FILE corrente ma compariva in quella precedente va perso. 
Ciò in effetti sostituisce i valori assunti per difetto del parametro originale. 


Se si incontra una successiva specifica FILE OCL senza il parametro JOB- 
YES ma con lo stesso parametro NAME della precedente OCL FILE con JOB- 
YES e il file non è stato ancora creato, tutti i parametri specificati sostituisco- 
no le specifiche originali assune per difetto. Qualsiasi parametro non indicato 
sulla specifica OCL FILE corrente verrà assunto al valore che era specificato 
sulla precedente specifica OCL FILE JOB-YES. Quando il passo di lavoro 
corrente termina, tutte le specifiche originali assunte per difetto per il file 
(salvo LOCATION, BLOCKS e RECORDS) ritorneranno ad essere i parame- 
tri assunti per difetto se il file non è stato creato. | parametri LOCATION, 
BLOCKS, RECORDS, usati per creare il file sono sempre quelli della specifi 
ca OCL FILE più di recente elaborata. 


Per un nuovo file può essere specificato JOB-YES. Il file specificato sarà ac- 
quisito per uso esclusivo del lavoro e non può essere condiviso. Il file non è 
effettivamente creato specificando JOB-YES; il file viene effettivamente crea- 
to quando è allocato, aperto e usato da un programma (alcuni linguaggi di 


‘programmazione combinano l'allocazione e l'apertura in una sola operazio- 


ne). Se vengono specificati i parametri LOCATION, BLOCKS o RECORDS, 
questi vengono usati soltanto quando il file viene creato, 


Se vengono indicati RETAIN-S e JOB-YES su una specifica OCL FILE, il file 
di lavoro può essere usato soltanto dal passo di lavoro che lo crea e non esi- 
ste dopo che quel passo di lavoro è terminato. 
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Se viene indicata una specifica OCL ATTR con il parametro RELEASE-YES, 
al passo di lavoro rilasciato vengono trasmessi solo quei file cui si fa riferi 
mento da parte delle specifiche OCL FILE tra la successiva coppia di speci- 
fiche OCL LOAD e RUN. Qualsiasi altra specifica OCL FILE, comprese le 
specifiche OCL FILE in cui è indicato JOB—YES, continueranno ad essere de- 
tenute dal lavoro originale e potranno essere usate nei seguenti passi di lavoro. 
Ciò significa che un passo di lavoro rilasciato da una specifica OCL ATTR 
non può disporre dei file che sono specificati all'esterno delle specifiche 
OCL RUN o LOAD di quel passo di lavoro. 


Quando viene specificato JOB-YES per una procedura a terminale richieden- 
te singolo e quella procedura richiama una procedura a terminali richiedenti 
multipli (MRT) che usa lo stesso file, i livelli di condivisione devono essere 
compatibili su entrambe le specifiche OCL FILE in entrambe le procedure. 


NO specifica che il file deve essere usato soltanto per quel passo di lavoro. 


WAIT specifica se la procedura deve attendere che il file diventi disponibile. 


YES specifica che se il file è già acquisito da un altro lavoro, la procedura 
deve attendere che il file diventi disponibile. Se il file è allocato o viene 
usato da un programma interrotto o in attesa oppure da un programma con 
l'attributo di programma sempre residente in memoria, viene visualizzato un 
messaggio e l'operatore può ritentare l'operazione di allocazione o cancellare 
il lavoro. 


NO specifica che se il file è già acquisito da un altro lavoro, la procedura 
deve continuare. NO può essere specificato soltanto su una specifica OCL 
FILE che è al di fuori di una coppia di specifiche OCL LOAD e RUN. L'e- 
spressione di sostituzione ?CD? può quindi essere usata per accertarsi se il 
file era acquisito dalla procedura, Se il file non era acquisito, l’espressione 
?CD? equivale a 2030 o 2031. Vedere Espressione ?CD? (Codice ritorno) per 
ulteriori informazioni sui valori sostituiti da questa espressione. 


EXTEND specifica che il file può essere esteso ogniqualvolta occorre spazio addi- 


zionale, 


‘| file possono anche essere estesi specificando un valore quando il file viene 


creato (da questo parametro o dalla procedura BLDFILE). Se quando un file 
viene creato viene specificato un valore di estensione, questo parametro 
EXTEND non deve essere specificato quando il file viene aggiornato. 


valore è un numero da 1 a 8 cifre di blocchi o record che specifica la quanti. 
tà di spazio addizionale da usare per l'estensione. Quando il file è stato crea- 
to, la dimensione del file era specificata in blocchi o record; usare la stessa 
unità di misura in questo caso. E’ possibile usare la procedura CATALOG 
per determinare come sarà indicata la dimensione del file. L'estensione deve 
essere sufficientemente ampia per contenere almeno un record. Se viene spe- 
cificato EXTEND-0, non si verifica alcuna estensione di file. 


Per tutti i tipi di file, e nelle operazioni di aggiunta per file sequenziali e a 
indice, il file sarà esteso quando la dimensione corrente del file non è suffi- 
Cientemente ampia. Il file sarà esteso in un'operazione di lettura per un file 
diretto se il record da leggere va oltre la fine del file. Se le specifiche OCL 
FILE per più di un lavoro indicano valori per l'estensione, verrà usato il va- 
lore della specifica OCL FILE nel job che ha provocato l'estensione. Notare 
che quando i file vengono condivisi, se un utente provoca un'estensione, tut- 
ti gli utenti di quel file possono trarre vantaggio dallo spazio addizionale del 
file, indipendentemente dal fatto che essi abbiamo specificato EXTEND sul- 
le rispettive specifiche OCL FILE. 


ZES 


Note: 


1. H parametro EXTEND, se usato su specifiche di file per i programmi di 
utilità di sistema $BICR, $POST e $MAINT è ignorato. 

2. Per usare il parametro EXTEND con file di tavoro (4) occorre specificare 
EXTEND quando il file viene creato. Tutti i successivi riferimenti all'in- 
terno del lavoro per quel file di lavoro usano la specifica di estensione 
cui si fa riferimento quando il file è stato creato. Il parametro EXTEND 
indicato nelle successive specifiche viene ignorato. 


DFILE specifica se il file deve essere del tipo in cui si possono cancellare i re- 
cord. Con tale tipo di file, è possibile usare nel programma l'operazione di 
cancellazione per cancellare un record dal file (il record non viene effettiva- 
mente rimosso ma è reso illeggibile). Il parametro DFILE è consentito soltan- 
to per i nuovi file o per i file esistenti che devono essere completamente rica- 
ricati con nuove informazioni. 


NO specifica che il file non deve essere del tipo in cui si possono cancellare i 
record. Non possono essere eseguite operazioni di cancellazione dal program- 
ma che usa questo file. 


YES specifica che il file deve essere del tipo in cui si possono cancellare i 
record. 


Se viene indicato DFILE-NO per un file esistente in cui si possono cancellare 
i record oppure se viene specificato DFILE-YES per un file esistente in cui 
non si possono cancellare i record, viene visualizzato un messaggio ed è possi-. 
bile continuare o cancellare il lavoro. i 


BYPASS specifica se il SSP deve consentire che un programma aggiunga un re- 
cord a un file a indice senza controllare la presenza di una chiave di indice 
doppia. 


NO specifica che il SSP deve controllare che non ci sia una chiave di indice 
doppia prima di aggiungere un nuovo record al file. Se non viene specificato 
alcun parametro, viene presunto BYPASS-NO. 


YES specifica che il SSP non deve controllare la presenza di una chiave: di 
indice doppia prima di aggiungere un record al file. 


DUPKEYS specifica, per un nuovo file a indice, se devono essere ammesse chiavi 
doppie. Se viene specificato il parametro DUPKEYS per un file che non è un 
nuovo file a indice, il parametro DUPKEYS viene ignorato. 


NO specifica che il file non deve contenere chiavi doppie. Se viene compiuto 
un tentativo di aggiungere nel file un record che ha la stessa chiave del re- 
cord, si verifica un errore. Se non viene specificato alcun parametro, si pre- 
sume DUPKEYS-NO. 


YES specifica che il file può contenere chiavi doppie. Il controllo delle chiavi 
doppie dell'indice non è eseguito anche se è specificato BYPASS-NO. 


DBLOCK specifica il numero di record da spostare tra la memoria centrale e un 
file su disco. Ciò consente di specificare un valore di blocco di record diverso 


dal valore specificato nel programma (lo sostituisce). Se non è specificato il 
parametro DBLOCK, viene usato il valore specificato nel programma. 


Vedere il manuale Concepts and Programmer's Guide per considerazioni sul 
blocco di record.di file. 


record deve essere un numero da 1 a 65,535. 
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IBLOCK specifica il numero delle entrate di indice da spostare tra la memoria 
centrale e il file a indice. Ciò consente di specificare un fattore di blocco 
di entrate indice diverso (che sostituisce) dal valore specificato nel program- 
ma. Se non è specificato il parametro IBLOCK viene usato i! valore specifi- 
cato nel programma, Se è specificato il parametro IBLOCK per un file che 


non è del tipo a indice, il parametro IBLOCK viene ignorato. 
entrate indice deve essere un numero da 1 a 65.535. 


STORINDX specifica se deve essere costruito un indice di memoria per un file 
a indice su disco. Se non viene specificato alcun parametro, il SSP determina 
se deve essere costruito l'indice di memoria. L'indice di memoria è anche 
detto indice di pista principale. 


YES specifica che deve essere costruito un indice di memoria (se non esiste 
già), per il file a indice su disco. Se esiste già un indice di memoria per il fi- 
le, viene usato quell’indice di memoria. 


NO specifica che non deve essere costruito alcun indice di memoria per il fi- 


le a indice. In ogni caso se esiste già un indice di memoria, questo verrà usa- 
to per elaborare il file. 


ampiezza massima indice memoria specifica l'ampiezza massima in K-byte dell’in- 
dice di memoria che deve essere creato dall'SSP. L'ampiezza massima deve 
essere un numero tra 1 e 6. Il numero indicato è arrotondato al numero pari 
superiore. Se l'indice di memoria già esiste per il file, viene utilizzata. 


Esempio 1 


Un programma crea un file su disco. Si suppongano i seguenti fatti relativi al 
file: 


e Il nome che il programma usa per fare riferimento al file è OUTPUT. 


e  L'’identificazione del file su disco è TRANSACT. 


e Il file contiene 200 record e sarà esteso di 100 record ogniqualvolta si riem- 
pie. 
e Il sistema sceglie l'area del disco per contenere il file. 


La specifica FILE che definisce il file è: 


// FILE NAME-OUTPUT, LABEL-TRANSACT,RECORDS-200,EXTEND-100 


Esempio 2 


Un programma sovrascrive (e cioè sovrappone), i contenuti di un file su disco esi- 
stente denominato IVENTORY. Il file è disposto al blocco numero 500 ed è lun- 
go 12 blocchi. !l nome del file usato dal programma è OUTFILE., Il file è aperto 


{nel programma) per l'emissione. 


// FILE NAME-OUTFILE,LABEL- IVENTORY,RETAIN-T,DISP-OLD 


Esempio 3 


Un programma deve creare un file dal quale si possono cancellare i record deno- 
minati FILE1. 


// FILE NAME-FILEl,DFILE-YES,RECORDS-250 


Esempio 4 


Entrambi i programmi PROG1 e PROG2 devono usare il file TRANSACT. E’ 
possibile usare quanto segue: 


// FILE NAME-TRANSACT,JOB-YES,DISP-SHRMM,WAIT-NO 

// IF ?CD?=0000 GOTO OK 

// * ‘Il file è attualmente usato, si vuole attendere (Y o N)?! 
//] IF ?64R?=N RETURN 

// FILE NAME-TRANSACT,JOB-YES,DISP-SHRMM,WAIT-YES 


// TAG OK 

// LOAD PROGI 

// RUN 

// LOAD PROG2 

// RUN 
Esempio 5 


Questo esempio mostra come usare il parametro DBLOCK per specificare che de- 
ve essere trasferito un numero maggiore di record di quello specificato nel pro- 


gramma, 


// LOAD PAYROLL 
// FILE NAME-PAYROLL,DISP-OLD,DBLOCK-30 
// RUN 
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SPECIFICA OCL FILE (PER FILE SU MINIDISCO) 


La specifica OCL FILE per file su minidisco, fornisce al SSP informazioni relative 
ad un file su minidisco. Il SSP usa queste informazioni per leggere da e scrivere 
su minidisco. Per ulteriori informazioni sui concetti di file su minidisco del Siste- 
ma/36, vedere il manuale Leaming about Your Computer. 


I programmi di utilità SSP che usano le specifiche OCL FILE per i file su minidi- 
sco, sono i seguenti: i 
Programma Descrizione 


di utilità del programma Procedure 


Formato base di interscambio TRANSFER 





Copia e visualizzazione di COPYDATA, DISPLAY, 
file su disco LISTDATA, ORGANIZE, 
RESTORE, SAVE 





$OUPRD Copia di minidischi COPYI1 





. $MAINT Manutenzione della libreria ALOCLIBR, FROMLIBR, 
RESTLIBR, SAVELIBR, 
TOLIBR 


Interscambio di dati in formato 
speciale E 
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Posizione: è richiesta una specifica OCL FILE per ogni file su minidisco che il 
programma crea o usa. La specifica OCL FILE per i file su minidisco deve 
seguire la specifica OCL LOAD e deve venire prima della specifica OCL RUN. 


// FILE NAME-nome file ,UNIT-Il [.1ABEL-identiricazione file | 


ci di validità) sDATE-{ mmegaa [.enoKcia voli 
sl ggmmaa 
L aammeg } | 


, LOCATION- { sl ,AUTO- { YES 
se NO 
S3 
Mli.nn 
M2.nn 





Nota: i parametri LOCATION o AUTO sono ignorati per i sistemi senza un mo- 
dulo a caricatore per minidischi. 


NAME specifica il nome che il programma usa per fare riferimento al file. Il no- 
me può essere qualsiasi combinazione di caratteri (numerici, alfabetici e spe- 
ciali) salvo le virgole (,), gii apici (’), e gli spazi in bianco. ! punti interroga- 
tivi (?), le barrette (/), i segni di uguale (=), i segni di maggiore (>) e i trat- 
tini di divisione sillabica (-), devono essere usati con cautela in quanto hanno 
significati speciali nell’ambito delle procedure. Il primo carattere del nome 
file deve essere alfabetico (da A a Z, # , $ 0 @), Il numero dei caratteri in 
un nome file non deve superare 8. 


UNIT-!1 specifica che il file è su uno o più minidischi. Per un file su minidisco 
deve essere specificato UNIT-11, Se il parametro UNIT viene omesso, si pre- 
sume UNIT-F1, 
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LABEL specifica il nome effettivo o identificazione col quale il file è riconosciu- 


to sul minidisco. Se viene omesso il parametro LABEL da una specifica FILE 
di minidisco, viene usato il nome specificato del parametro NAME, Se il file 
è esistente, è richiesto un parametro LABEL quando il nome che il program- 
ma usa per fare riferimento al file differisce dal nome che identifica il file 
sul minidisco. 


Il nome può essere qualsiasi combinazione di caratteri (numerici, alfabetici e 
speciali) eccetto le virgole (,), gli apici (’), e gli spazi in bianco, In ogni caso 
i punti di domanda (?), le barrette (/), i segni di uguale (=), i segni di mag- 
giore (>) e i trattini di divisione sitlabica (-), devono essere usati con cautela 
in quanto hanno significati speciali nell’ambito delle procedure. Il primo 
carattere del nome file deve essere alfabetico (da A a Z, #, $ o @). Il nu- 
mero dei caratteri in un nome file non deve superare 8. 


Se c’è più di un file su minidisco con lo stesso nome, i file devono avere di- 
verse date di creazione. In tutti i casi (salvo quando si sta usando la proce- 
dura SAVE oppure il programma di utilità $COPY per salvare tutti i file), il 
SSP visualizza un messaggio di avvertimento prima di creare un file con lo 
stesso nome di un file su minidisco esistente. E’ possibile in tal caso (1) la- 
sciare che il SSP crei il file con una data di creazione diversa, (2) inserire un 
altro minidisco e quindi lasciare che il SSP crei il file su quel minidisco, op- 
pure (3) cancellare il lavoro. Se si sta usando la procedura SAVE o il pro- 


gramma di utilità $COPY per salvare tutti i file, la data di creazione di cia- ‘ 


scun file su disco diventa la data di creazione del corrispondente file su mini- 
disco. Pertanto, se esiste più di un file su disco con lo stesso nome, il mini- 
disco o i minidischi conterranno a loro volta quei file con lo stesso nome e 
con diverse date di creazione. ll SSP non visualizza in questo caso un mes- 
saggio di avvertimento, 


Se, c'è più di un file su minidisco con lo stesso nome indicato su una spe- 
cifica file e non si indica il parametro DATE, il programma elabora il primo 
file sulla VTOC del minidisco con il nome indicato. A differenza dell’elabo- 
razione del disco, non c'è ricerca del file con la data più recente. 


LT 


RETAIN specifica il numero dei giorni durante i quali un file deve essere con- 


servato. ll parametro RETAIN viene usato per calcolare una data di sca- 
denza. Ogniqualvolta viene specificato RETAIN per un file, il SSP determi- 
na la data di scadenza del file aggiungendo la data del passo di lavoro al 
numero di giorni specificato dal parametro RETAIN. Se la data del pro- 
gramma non è valida, viene visualizzato un messaggio di errore ed è possibile 
cancellare il lavoro o continuare l’elaborazione. Se si decide di continuare, 
la data di scadenza viene impostata uguale alla data di creazione. 


giorni di validità può essere qualsiasi numero da 0 a 999, Se non è specifi- 
cato RETAIN quando viene creato un nuovo file, si presume 1 giorno, ©- 
viene specificato qualsiasi numero fino a 998, il file è conservato per ll 


numero specificato di giorni. Se viene specificato: 999, il file è considerato 
permanente e può essere cancellato soltanto dalla procedura DELETE. 


Quando il SSP crea un file su minidisco, il SSP scrive la data di creazione 
e calcola la data di scadenza del file in formato internazionale (aammgg). Se 
ad un file su minidisco esistente che non è permanente si fa riferimento da 
parte di una specifica OCL FILE con un parametro RETAIN, la data di sca- 
denza del file è modificata in quella determinata dal parametro RETAIN. 


Se a un file su minidisco esistente permanente si fa riferimento da parte di 
una specifica OCL FILE con un parametro RETAIN non permanente, viene 
visualizzato un messaggio ed è possibile cancellare il lavoro o continuare 
l'elaborazione. Se si dice di continuare l'elaborazione dopo la visualizzazione 
del messaggio, il file è considerato un file permanente, 


Ogniqualvolta il SSP crea un file su un minidisco o aggiunge a un file esi- 
sterite su minidisco, tutti gli altri file su minidisco le cui date di scadenza 
sono le stesse o precedenti di quella della data del passo di lavoro e tutti i 
file scaduti vengono cancellati automaticamente. Se un file che riceve delle 
aggiunte è scaduto, non viene cancellato. 


Quando il SSP controlla se un file è scaduto, viene controllata ciascuna data 
di scadenza per accertarsi che sia nel formato internazionale (aammgg) con- 
frontando i primi due caratteri con 70. Se i primi due caratteri sono minori 
di 70, si presume che la data di scadenza non sia nel formato internazionale 
e sia nello stesso formato della data di sessione (le date in formato interna- 
zionale precedenti al 1970 e le date di scadenza che non figurano nei for- 
mati della data di sessione o internazionale, non sono lette correttamente dal 
SSP. Ciò può far sì che il SSP cancelli i file non scaduti o trattenga.i file 
scaduti). 


Il nuovo file creato su un minidisco, deve iniziare al primo settore disponibi- 
fe oltre l’ultimo file non scaduto, Lo spazio che era occupato da un file can- 
cellato, non viene riutilizzato se è seguito da file non scaduti. 
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DATE specifica la data di creazione di un file esistente e assicura che si è elabo- 


rata l'appropriata versione di un file. 


Se si indica un nome e una data di creazione per la specifica OCL FILE, il 
SSP visualizza un messaggio se non può trovare sul minidisco un file con 
quel nome e con quella data. E’ possibile inserire un altro minidisco e il SSP 
cercherà il file specificato su quel minidisco. 


Quando viene creato un file su minidisco, il suo nome, la sua data di scaden- 
za e la data di creazione (data del passo di lavoro) sono scritti sul minidisco 
per l’identificazione. Quando viene creato un file su minidisco su un Siste- 
ma/36, il SSP scrive sia la data di creazione che la data di scadenza nel for- 
mato internazionale (aammgg). Il SSP converte la data del passo di lavoro 
nel formato internazionale prima di scriverla sul minidisco. Se viene specifi- 
cato il parametro DATE per un file su minidisco esistente, il SSP converte 
la data specificata nel formato internazionale prima di usare il file. Per assi- 
curare la corretta. elaborazione, i file creati da altri sistemi devono avere la 
data di creazione e di scadenza scritte nel formato internazionale. 


Per informazioni sulla data del passo di lavoro, vedere la Specifica OCL DA- 
TE. 


PACK specifica l'ID di volume del minidisco ed è richiesto quando un program- 


ma crea un file o aggiunge un file ad un minidisco. L'ID di volume è posto 
sul minidisco della procedura INIT e può essere qualsiasi combinazione di 
6 caratteri alfanumerici o meno. 


L'ID di volume specificato al parametro PACK è confrontato con {’ID di vo- 
lume del minidisco; se non sono identici, viene visualizzato un messaggio. E’ 
possibile continuare l'elaborazione (VID di volume viene ignorato), inserire 
il minidisco corretto o cancellare il lavoro. 


Se non è fornito un parametro PACK sulla specifica FILE del minidisco per 
un file su minidisco che viene creato o aggiunto, viene visualizzato un mes- 
saggio e occorre cancellare il lavoro. 


Il parametro PACK non è richiesto per un file su minidisco che viene letto; 
in ogni caso occorre assicurarsi che sia inserito l’appropriato minidisco. 


LOCATION specifica una locazione del minidisco. 


$1, S2 o S$3 identifica un singolo alimentatore di minidisco. Se il file si trova 
su più di un minidisco, l'alimentatore specificato deve contenere il primo mi- 
nidisco del file. Se non è specificato LOCATION, si presume S1. 


M1.nn o M2.nn identifica una locazione del caricatore, M1 indica il primo 
caricatore e M2 indica il secondo, nn è un numero da 01 a 10 che identifica 
la locazione nell’ambito del caricatore. Specificare M1 o M2 equivale a speci- 
ficare M1.01 o M2.01 rispettivamente. ni 


Per l'emissione su minidischi, il primo minidisco destinato a ricevere l’emis- 
sione deve essere nella locazione specificata. Se il minidisco in quella loca- 
zione non è in grado di ricevere l'emissione, il sistema non cerca negli altri 
alimentatori un altro minidisco. Per contro, viene visualizzato un messaggio 
di errore e l'operatore deve inserire un minidisco in grado di ricevere l’emis- 
sione nell’alimentatore specificato. 


sor 


AUTO specifica come devono essere elaborati i file su minidisco contenuti su più 
di un minidisco. E’ possibile usare la specifica OCL ALLOCATE per sostitui- 
re questo parametro; vedere la Specifica OCL ALLOCATE per ulteriori in- 
formazioni. 


YES specifica: 


e Se è indicato S1, S2 o S$3 nel parametro LOCATION, il programma può 
usare tutti e tre i singoli alimentatori. L'elaborazione inizia con il mini- 
disco che si trova nell’alimentatore specificato sul parametro LOCATION. 
Dopo che è stato elaborato il minidisco nell'alimentatore $3, il SSP vi- 
sualizza un messaggio; l'operatore deve quindi inserire il successivo mini- 
disco. L'elaborazione riprende col minidisco nell’alimentatore S1. 


e Se viene specificato M1,nn o M2.nn nel parametro LOCATION, il pro- 
gramma può usare entrambi gli alimentatori di caricatore. L'elaborazione 
inizia con il minidisco nella locazione specificata e continua fino al mini- 
disco nella locazione M2.10. Se rimangono da elaborare altri minidischi 
il SSP visualizza un messaggio; l'operatore deve quindi inserire i succes- 
sivi caricatori. L'elaborazione riprende alla locazione M1.01. 


NO specifica: 


e Se viene indicato S1, S2 o S3 nel parametro LOCATION, il programma 
usa soltanto l'alimentatore specificato. Dopo che un minidisco è stato 
elaborato, il SSP visualizza un messaggio; l'operatore deve inserire il suc- 
cessivo minidisco nell'alimentatore specificato. 


e Se viene specificato M1.nn o M2.nn nel parametro LOCATION, il pro- 
gramma usa soltanto il caricatore specificato. L'elaborazione inizia con il 
minidisco nella locazione specificata e continua fino all'ultimo minidisco 
nel caricatore, Se rimangono altri minidischi da elaborare, il SSP visualiz- 
za il messaggio; l'operatore deve inserire i! successivo caricatore nello 
stesso alimentatore. L'elaborazione riprende alla prima locazione nel cari- 
catore. 


Esempio 


Questo esempio mostra come le specifiche OCL FILE sono usate dal programma 
di utilità $COPY per copiare su minidisco un file su disco. Il nome del file su 
disco è TRANSI, che deve essere il nome del file su minidisco. Il programma 
$COPY fa riferimento ad un file di immissione (file su disco in questo esempio) 
come COPYIN; esso si riferisce al file di emissione (in questo esempio il file su 
minidisco) come COPYO. Il minidisco ha un ID di volume di VOL001 e il file 
su minidisco deve essere conservato per 8 giorni. 


// LOAD $COPY 
// FILE NAME-COPYIN,UNIT-F1,LABEL-TRANSI 
// FILE NAME-COPYO,UNIT-I1,LABEL-TRANSI,RETAIN-8,PACK-VOLOOl 


// RUN 
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SPECIFICA OCL FILE (PER | FILE SU NASTRO) 


La specifica OCL FILE per i file su nastro fornisce all'SSP informazioni relative 
ad un file su nastro. L'SSP usa queste informazioni per leggere da e scrivere su 
un nastro. Per ulteriori informazioni sui concetti di file su nastro del Sistema/36, 
vedere il manuale Learning about Your Computer ed il manuale Concepts and 
Programmer's Guide. 


I programmi di utilità dell'SSP che usano le specifiche OCL FILE per i file su 
nastro sono i seguenti: 


Descrizione Programma Procedure 
utilità 


$TCOPY Formato base d’interscambio TAPECOPY 


"$COPY Copia e visualizzazione di file COPYDATA, LISTDATA, 
su disco LISTFILE, RESTORE, 


SAVE, SECSAVE, 
SECREST 


$MAINT Manutenzione libreria FROMLIBR, RESTLIBR, 
SAVELIBR, JOLIBR, 
BLDLIBR, JOBSTR 
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Posizionamento: Per ciascun file che un programma crea o usa è richiesta una 
specifica OCL FILE. La specifica OCL FILE per i file su nastro deve seguire la 
specifica OCL LOAD e precedere la specifica OCL RUN. 


NAME-nome file [,sEQnUN-mumero | [|\LARRI-ident. rile] 


NS "ia volume, id volume,...id volume! 
NL 
BLP 


$REI-f SL sini volume } 


i; di SA s«DATF- (mnggaa | 


L 


gemmaa 
aammgg 


T2 


RECFM-|F |. BLKL-lungh. blocco | |. RECL- lungh. recora | 
V 
FB 


|.0EnSEP1-1600| sAUTO- f YES | , END- (REWIND 
NO | LEAVE 
UNLOAD 





Nota: ll parametro AUTO è ignorato per i sistemi con una sola unità nastro. 


NAME specifica il nome che il programma usa per fare riferimento al file. Il no- 
me file può essere qualsiasi combinazione di caratteri (numerici, alfabetici e 
speciali), salvo le virgole (,), gli apici (") e gli spazi in bianco. In ogni caso, i 
punti interrogativi (?), le barre (/) ed i segni di uguale (=), i segni di maggiore 
di (>) ed i trattini di divisione sillabica (-) devono essere usati con cautela in 
quanto hanno speciali significati nell'ambito delle procedure. Il primo carattere 
di un nome file deve essere alfabetico (da A a Z), # $ o @). Il numero di ca- 
ratteri in un nome file non deve superare 8. 


SEONUM specifica la posizione del file quando un nastro contiene più di un file. 
Per esempio, se il file di immissione che si desidera usare è il quinto sul na- 
stro, occorre specificare SEONUM-5 per accedere al file. Questo parametro, 
a differenza di LABEL, è usato principalmente con i nastri con identificazione 
non standard o senza identificazione e con i nastri con esclusione dell’elabora- 
zione dell'identificazione. 
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Se viene specificato SEONUM e viene specificato anche il parametro LABEL 
per un file di immissione, la specifica OCL FILE elaborerà per primo il para- 
metro SEQNUM. li nome dell’identificazione di testata del file trovato dal pa- 
rametro SEQNUM è confrontato con il nome dell’identificazione indicata nella 
specifica FILE. Se i nomi delle identificazioni sono gli stessi, l'elaborazione 
continua. Se sono diversi, la specifica FILE cerca il file usando il parametro 
LABEL. 


Se non vengono specificati nè il parametro SEONUM nè il parametro LABEL, 
il nome file viene usato come nome dell’identificazione. 


LABEL specifica il nome effettivo o identificazione con il quale il file è contras- 


segnato sul nastro. Se dalla specifica FILE su un nastro viene omesso il para- 
metro LABEL, viene usato il nome specificato dal parametro NAME. Se il file 
esiste già, è indispensabile un parametro LABEL quando il nome che il pro- 
gramma usa per fare riferimento al file differisce dal nome che identifica il 
file su nastro. ll parametro LABEL è valido solo per nastri con identificazione stan- 
dard: se il parametro REEL non è REEL-SL, LABEL viene ignorato. 


Il nome può essere qualsiasi combinazione di carattere (numerici, alfabetici e 
speciali) salvo le virgole (,) gli apici (') e gli spazi in bianco. In ogni caso i 
punti interrogativi (?), le barre (/), i segni di uguale {=) i segni di maggiore di 
(>) ed i trattini di divisione sillabica (-) devono essere usati con cautela in 
quanto hanno speciali significati nell'ambito delle procedure. Il primo carattere 
di un nome deve essere alfabetico (da A a Z, #, $ o @). Il numero di caratteri 
in un nome non deve superare 17. 


Se due o più file su nastro hanno lo stesso nome, {salvo quando si sta 
usando la procedura SAVE oppure il programma di utilità $COPY per salvare 
tutti i file), I'SSP visualizza un messaggio di avvertimento prima di creare 
un file con lo stesso nome di uno già esistente su nastro. È possibile 
in tal caso (1) lasciare che I'SSP crei il file, (2) inserire un altro nastro e quindi far sì 
che I’SSP crei il file su quel nastro, oppure (3) cancellare il lavoro. Se si sta 
usando la procedura SAVE o il programma di utilità $COPY per salvare tutti 
i file, la data di creazione di ciascun file su disco diventa la data di creazione 
del corrispondente file su nastro. Pertanto se esistono due o più file su disco 
con lo stesso nome, il nastro conterrà a sua volta quei file con lo stesso nome 
e con diverse date di creazione. L'SSP non visualizza in questo caso un mes- 
saggio di avvertimento. 


Se due o più file su nastro hanno lo stesso nome indicato in una specifica 
FILE e non viene indicato il parametro DATE, il programma elabora il primo 
file sul nastro con il nome specificato. Se due o più file hanno la stessa identificazio- 
ne e la stessa data di creazione, il programma elabora il primo file su nastro con quel- 
la identificazione e quella data. Per elaborare gli altri file con la stessa identificazione 
e data si deve specificare con il parametro SEQNUM la loro posizione sul nastro. 


REEL specifica il tipo di elaborazione di identificazione da eseguire per il nastro. 


SL specifica l'identificazione di nastro standard, Se non è specificato REEL, 
si presume SL. 


NS specifica l'identificazione di nastro non standard. Se è specificato UNIT- 
TC, REEL-NS non è valido. 


NL specifica il nastro non identificato. Se è specificato UNIT-TC, REEL-NL non 
è valido. 


BLP specifica che l'elaborazione dell’identificazione deve essere esclusa ma il 
nastro deve avere un'identificazione standard. Se è specificato UNIT-TC, REEL- 
BLP non è valido. 


VOLID specifica I'ID di volume del nastro o dei nastri che vengono elaborati. Il 
parametro VOLID è valido soltanto per i nastri con identificazione standard 
(REEL-SL). Il nome può contenere un massimo di 6 caratteri alfanumerici 
(daAaZ,da0a9,@ # $). 


id volume specifica "ID di volume del nastro da elaborare. Se viene elaborato 
un file di immissione multivolume e nel parametro VOLID viene specificato 
soltanto un ID di volume, I'ID di volume del primo nastro elaborato deve cor- 
rispondere all'ID di volume specificato, Gli ID di volume del secondo e dei 
successivi nastri non verigono esaminati e non devono corrispondere all"1D di 
volume specificato. Deve essere specificato almeno un ID di volume per un file 
di emissione multivolume. 


Se viene elaborato un file di immissione multivolume e nel parametro VOLID 
viene specificato soltanto un ID di volume, l'ID di volume del primo nastro 
elaborato deve corrispondere all'ID di volume specificato. L'ID di volume del 
secondo e dei successivi nastri non devono corrispondere all’ID di volume del 
primo nastro. 


“id volume,id volume,...id volume” specifica che se viene elaborato un file mul- 
tivolume e nel parametro VOLID deve essere specificato più di un ID di vo- 
lume, questi devono essere racchiusi tra apici (’) e separati da una virgola (,); 
per esempio, 'vol2,vol2,vol3’. E’ possibile specificare un massimo di 30 ID 
di volume. L’ID di volume di ciascun nastro elaborato deve quindi corrispon- 
dere ed essere nello stesso ordine degli ID di volume specificati. 


UNIT specifica su quale unità nastro deve iniziare l'elaborazione. Per un file su na- 
stro devono essere specificati UNIT-T1, UNIT-T2 o UNIT-TC. Se il parametro 


UNIT viene omesso, si presume UNIT-T1. 
T1 specifica che l'elaborazione del nastro deve iniziare sull'unità nastro 1. 


T2 specifica che l'elaborazione del nastro deve iniziare sull'unità nastro 2. 


TC specifica che l'elaborazione del nastro deve essere su un nastro a cassetta. 


RETAIN specifica il numero di giorni durante i quali il -file deve essere conserva- 
to. Il parametro RETAIN è usato per calcolare una data di scadenza per i nastri con 
identificazione standard. Ogniqualvolta per un file viene specificato RETAIN, I SSP 
determina la data di scadenza del file aggiungendo la data del passo di lavoro al 
numero di giorni specificato ne! parametro RETAIN. Se la data del programma non 
è valida, viene visualizzato un messaggio di errore ed è possibile cancellare il lavoro 
o continuare l'elaborazione. Se si decide di continuare, la data di scadenza viene 
posta uguale alla data di creazione. 


giorni di conservazione può essere qualsiasi numero compreso fra 0 e 999. Se 
RETA!N non è specificato quando viene creato un nuovo file, si presume un 
giorno. Se è specificato qualsiasi numero fino a 998, il file viene conservato 
per il numero specificato di giorni. Se viene specificato 299, il file è considera- 
to permanente e può essere cancellato soltanto quando il nastro viene inizializ- 
zato di nuovo. 


Quando I|’SSP crea un file su nastro, I'SSP scrive la data di creazione e calcola 
la data di scadenza del file in formato internazionale (cyyddd). Se ad un file su na- 
stro esistente si fa riferimento da parte di una specifica OCL FILE con il parametro 
RETAIN, quest’ultimo viene ignorato. 
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La data di scadenza non viene esaminata quando il file viene allocato ma quando 
viene inizializzato il nastro (dalla procedura TAPEINIT). 


Solo al primo file sul nastro viene esaminata la data di scadenza. 


Quando viene creato un nuovo file su nastro, viene inserito dopo l'uitimo pre- 
sente sul nastro. 


DATA specifica la data di creazione di un file esistente ed assicura che sia elaborata 


la versione corretta di un file. 


Se si indica sia il nome che la data di creazione nella specifica OCL FILE, I'SSP 
visualizza un messaggio se non può trovare un file con quel nome o quella data 
sul nastro montato. E’ possibile in tal caso montare un altro nastro in modo 
che |’SSP cerchi su di esso il file specificato. 


Quando viene creato un file su nastro, il suo nome, la sua data di scadenza e la 
data di creazione {data del passo di lavoro) sono scritti su nastro come identifi- 
cazione. Quando viene creato un file su nastro sul Sistema/36, l’SSP scrive sia 
la data di creazione che la data di scadenza nel formato internazionale 
(cyyddd). L'SSP converte la data del passo di lavoro nel formato internaziona- 
le prima di scriverla sul nastro. Se è specificato il parametro DATA per un file 
su nastro esistente, l'SSP converte la data specificata nel formato internazionale 
prima di usare il file. Per assicurare un'elaborazione corretta, i file creati da altri 
sistemi devono essere creati in modo tale che la data di creazione e la data di 
scadenza siano scritte nel formato internazionale. 


Per informazioni sulla data del passo di lavoro, vedere la Specifica OCL DATE. 


RECFM specifica il formato dei record dei file di emissione e di immissione. Se il 


parametro RECFM non viene specificato, viene assunto F, salvo che si stia leg- 
gendo o aggiungendo su un file ad identificazione standard (REEL-SL) che ha 
l’identificazione HDR2. Se sul file è presente HDR2, viene usato il formato re- 
cord specificato in HDR2. 


F specifica il formato a record sbloccati di lunghezza fissa. Se è specificato UNIT- 
TC, RECFM-F non è consentito. 


V Specifica il formato a record sbloccati di lunghezza variabile (valido solo per 
i file di immissione). Se è specificato UNIT-TC, RECFM-F non è consentito. 


.FB specifica il formato a record bloccati di lunghezza fissa. 


BLKL-lunghezza blocco specifica il numero di byte in un blocco fisico di dati su 


nastro. li parametro può essere qualsiasi valore fra 18 e 32767 byte. Il parame- 
tro BLKL può essere usato soltanto per i record bloccati di lunghezza fissa 
{viene specificato il parametro RECFM-FB). ll parametro BLKL è indispensa- 
bile per tutti i file di emissione che hanno record bloccati di lunghezza fissa 
e per tutti i file di immissione che hanno record bloccati di lunghezza fissa non 
elaborati con identificazioni standard HDR2 (cioè è specificato REEL-NS, REEL- 
NL, REEL-BLP, REEL-SL e il file da elaborare non ha HDR2}). 


Cats 


RECL-lunghezza record specifica il numero di byte in un record logico di dati su na- 
stro. Il parametro può avere qualsiasi valore, da 18 a 4096 byte. Il parametro 
| RECL è indispensabile per i file di immissione che non vengono elaborati con 
identificazioni standard HDR2 (se cioè è specificato REEL-NS, REEL-NL, REEL- 
BLP, o REEL-SL e il file da elaborare non ha l’identificazione HDR2). Se è speci- 
ficato il parametro RECL per un nastro con identificazione standard (se cioè 
è specificato REEL-SL e il file ha identificazione standard HDR2}), il parametro 
deve corrispondere alla lunghezza record contenuta nell’ambito dell’identifica- 
zione del nastro. Se non corrisponde, viene emesso un messaggio di errore. 


END specifica la posizione ‘del nastro dopo che il file è stato elaborato. 


REWIND specifica che il mastro deve essere riavvolto dopo che il file è stato 
elaborato. Se il parametro END non è specificato, si presume REWIND. 


LEAVE specifica che il nastro deve rimanere nella posizione in cui è avvenuto 
l'ultimo accesso. 


UNLOAD specifica che il mastro deve essere riavvolto e scaricato dopo che il 
file è stato elaborato. 


AUTO specifica come devono essere elaborati i file contenuti su più di un nastro. 
E’ possibile usare la Specifica OCL ALLOCATE per escludere questo parame- 
tro; vedere la Specifica OCL ALLOCATE per ulteriori informazioni. 


VES specifica che se si termina il nastro mentre si elabora un file, viene com- 
piuto un tentativo per continuare l'elaborazione del file allocando l’altra unità 
nastro. Se quella-unità nastro non può essere allocata, verrà usata l’unità nastro 

originale per il successivo valore. Se non è specificato il parametro AUTO, si 
presume AUTO-VYES. 


.NO specifica che non deve essere effettuato alcun tentativo di continuare un 
file sulla successiva unità nastro. 


DENSITY-1600 specifica il numero di byte per pollice con il quale i file devono es- 
sere scritti sul nastro o letti dal nastro. Se è specificato UNIT-TC, DESINTY-1600 
non è consentito. 


Esempio 


Questo esempio mostra come sono state usate le specifiche OCL FILE dal pro- 
gramma di utilità $COPY per copiare su un nastro nell'unità nastro 1 un file su 
disco, Il nome del file su disco è TRANS1, che deve essere anche il nome del file 
su nastro. ll programma $COPY farà riferimento al file di immissione {il file su 
disco, in questo esempio) come COPYIN; esso si riferisce al file di emissione (il fi- 
le su nastro) come COPYO. Il nastro. ha un ID di volume di VOL001, deve essere 
elaborato come nastro con identificazione standard nel formato a record bloccati 
di lunghezza fissa, con una lunghezza di blocco di 24576 byte. Se il file esaurisce 
il nastro, non deve essere usata l'altra unita nastro per rinire la copia del file. Dopo 
che il file è stato copiato, il nastro deve essere riavvolto e scaricato per la rimozione. 
ll file su nastro deve essere conservato per otto giorni. 


// LOAD $ COPY 

// FILE NAME-COPYN,UNIT-F1,LABEL-TRANS1 

// FILE NAME-COPYO,LABEL-TRANS1, REEL=SL,VOLIDrVOLO01, 
UNIT-T1,RETAIN-8,RECL=50, RECFM-FB, BLKL=-24576, DENSITY 
1600,AUTO-NO, END-UNLOAD 

// RUN 
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SPECIFICA OCL FORMS 
La specifica OCL FORMS fornisce informazioni sulla stampatrice da usare duran- 
te una sessione all’unità video. La specifica OCL FORMS potrà essere usata per 
impostare il modo in cui l'emissione deve essere stampata per i lavori che conten- 
gono parecchi passi di stampa, senza dover indicare parecchie volte le stesse infor- 
mazioni sulle specifiche OCL PRINTER, 
e L'ID della stampatrice da usare per tutta l'emissione stampata 
e ll numero delle righe da stampare per pagina 
el numero di modulo 
e La densità di stampa orizzontale (caratteri per pollice) 


e La densità di stampa verticale (righe per pollice) 


Le modifiche effettuate dalla specifica OCL FORMS rimangono valide fino al ter- 
mine della sessione dell'unità video o fino a che non sono modificate: 


e Da un'altra specifica FORMS 

e Dalla specifica PRINTER (solo per quel passo di lavoro) 

e Dalla procedura LINES 

e Dalla procedura PRINT 

Un lavoro inserito nella coda dei lavori usa i valori che erano in effetto quando il 
lavoro è stato inserito nella coda. In ogni caso se la procedura in esecuzione dalla 


coda di lavori contiene una specifica OCL FORMS, in essa viene usata la specifica 
OCL FORMS. 
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Posizione: \a specifica OCL FORMS può comparire ovunque tra le specifiche 
OCL. 


SYSTEM 


// FORMS gli e [1105 valore | FoRISKO-numero modulo | 


3CPI=(10 sLPI-{L 
15 6 
8 





Se viene usata la specifica FORMS deve essere indicato almeno un parametro. 


DEVICE specifica la stampatrice da usare per l'emissione stampata. Sulla stampa- 
trice specificata vengono stampate l'emissione di lista di sistema, l'emissione 
del tasto STAMPA e qualsiasi altra emissione su stampa della sessione. 


Se non viene specificato alcun parametro DEVICE, le assegnazioni di stampa- 
trice non vengono modificate. ll parametro DEVICE della specifica OCL 
PRINTER può escludere questo parametro. 


id stampatrice specifica l'ID del terminale della stampatrice da usare. E' pos- 
sibile usare il comando STATUS WORKSTN per determinare l'ID di stampa- 


trice. 


SYSTEM specifica che deve essere usata la stampatrice di sistema. 
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LINES specifica il numero di righe di stampa per pagina. Il numero massimo di 


righe per pagina che è possibile specificare è 112. Se non viene specificato 
il parametro LINES e non era stato impostato precedentemente il numero di 
righe per pagina durante la sessione, il sistema usa il valore specificato per 
l’unità video durante la configurazione del sistema, mediante la procedura 
SET o mediante il programma di utilità $SETCF. Se viene usata in un pro- 
gramma una specifica di contatore di riga. quella specifica rimane in effetto 
soltanto per la durata di quel programma, 


Per i programmi forniti dalla IBM e per la maggior parte dei programmi scrit- 
ti dagli utenti, la stampatrice salta ad una nuova pagina quando arriva al nu- 
mero di riga inferiore di 6 a quello specificato. Per esempio, se viene spe- 
cificato LINES--66, la stampatrice salta ad una nuova pagina dopo aver stam- 
pato la riga 60. Inoltre, la stampatrice inizia alla riga 6 della nuova pagina. 
Pertanto se si specificano 66 righe per pagina, si ottengono in effetti 54 ri- 
ghe di emissione stampata per pagina (66 — 12 = 54). Se viene specificato 
LINES-13, viene stampata una riga per pagina. Quando viene specificato 12 
righe o meno, la stampa si verifica su una sola riga di ciascuna pagina. 


Per le operazioni di stampa dai programmi, it SSP indica una condizione di 
eccedenza quando vengono stampate sei righe in meno del numero specifi- 
cato (sia nel programma che nella specifica FORMS). 


FORMSNO specifica il numero di codice del modulo di stampatrice da usare per 


CP 


l'emissione stampata della sessione di unità video, (Ciascun tipo di modulo 
deve avere un numero esclusivo assegnato dall'utente). Il numero di modulo 
può essere qualsiasi combinazione di un massimo di 4 caratteri salvo ie vir- 
gole (,), gli apici (’), e gli spazi in bianco. In ogni caso i punti interrogativi 
(?), le barrette (/) e i segni di uguale (=) e i trattini di divisione sillabica (-), 
devono essere usati con cautela in quanto hanno speciali significati nell’am- 
bito delle procedure. 


Se viene specificato un numero di modulo, il SSP chiede all'operatore che 
controlla la stampatrice di installare nella stampatrice i moduli con il nume- 
ro speciicato, se non sono già installati, 


specifica la densità orizzontale di stampa e cioè il numero di caratteri per 
pollice da usare per l'emissione stampata per la sessione dell'unità video. | 
valori che possono essere specificati sono 10 o 15. Se viene usato CPI-15, 
l'emissione deve essere stampata su una stampatrice 4214, 5225 o 5224. 
Se viene tentato CPI-15 su un'altra stampatrice, viene visualizzato un mes- 
saggio e l'operatore che controlla la stampatrice può cancellare o continuare 
il lavoro. CPI viene ignorato se l'emissione viene stampata su una stampatrice 
5219 o 4224. 


La specifica PRINTER può essere usata per modificare il valore CPI per un 
particolare passo di lavoro ma rimane in effetto soltanto per quel passo di 
lavoro. Se non è specificato il parametro CPI e non era stato impostata pre- 
cedentemente il valore di caratteri per pollice durante la sessione, il sistema 
usa il valore impostato quando la stampatrice è stata configurata (10 o 15). 
Poichè l'emissione può essere inviata su qualsiasi stampatrice dal file di stampa 
differita, il valore di configurazione assunto viene determinato al momento delia 
stampa effettiva non nel file di stampa differita. 


Se non è stato specificato alcun valore CPI al momento della configurazione, 
il valore CPÌ è controllato da un interruttore sulla stampatrice. 


LPI specifica la densità verticale di stampa (cioè le righe per pollice) da usare per 


era 


l'emissione stampata dalla sessione dell'unità video. | valori che possono esse- 
re specificati sono 4, 6 e 8. Se l'emissione viene stampata su una stampatrice 
diversa dalla 5224, 5225, 4214, 4224, il parametro LPI è ignorato. 


La specifica PRINTER può essere usata per modificare il valore LPI per un 
particolare passo di lavoro ma rimane in effetto soltanto per quel passo di 
lavoro, Se il parametro LPI non è specificato e non era stato precedentemen- 
te impostato il parametro righe per pollice durante la sessione, il sistema usa 
il valore impostato al momento della configurazione della stampatrice (4, 6 o 
8). (Poichè l'emissione può essere inviata su qualsiasi stampatrice dal file di stam- 
pa differita, il valore di configurazione assunto viene determinato al momento della 
stampa effettiva non nel file di stampa differita). Se non era stato specificato alcun 
valore LPI al momento della configurazione della stampatrice, il valore LPI è control- 
lato da un interruttore sulla stampatrice. 


Esempio 1 


La specifica FORMS nella procedura seguente indica che la lunghezza dei moduli 
per il lavoro è di 20 righe per pagina e che deve essere usato il modulo CHEC. 


// FORMS LINES-20,FORMSNO-CHEC 

// LOAD PRNTCHEC 

// PRINTER NAME-CHECKS,SPOOL-NO,ALIGN-YES 
// RUN 


Esempio 2 


La specifica FORMS seguente indica che: 


La stampatrice da usare ha un ID di terminale di P3 (la stampatrice è una 
stampatrice modello 5225). 


La densità verticale di stampa è di 8 righe per pollice. 


La lunghezza dei moduli è di 11 pollici (27,9 cm). Pertanto le righe per pa- 
gina devono essere 88 (11 x 8 = 88). 


La densità di stampa orizzontale deve essere di 15 caratteri per pollice. 


| programmi da eseguire sono denominati TEST e TESTI. 


// FORMS DEVICE-P3,LINES-88,LPI-8,CPI-15 
// LOAD TEST 

// RUN 

// LOAD TESTI 

// RUN 
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SPECIFICA OCL IMAGE 


La specifica OCL IMAGE indica l'immagine della cinghia di stampa da usare per 
tutte le emissioni sulle stampatrici 3262 dall'unità video richiedente. La specifica 
IMAGE interessa soltanto i dati per la stampatrice 3262. | dati da stampare da 
parte dì altre stampatrici sul sistema non sono influenzati. 


E’ inoltre possibile usare la specifica OCL IMAGE per convertire lettere minusco- 
le in maiuscole per quelle cinghie di stampa che non possono stampare lettere 
minuscole. 


Per ciascuna unità video, una speciale tabella chiamata Tabella di specifica della 
stampatrice contiene il nome del membro dell'immagine di stampa da usare 
quando viene stampata l'emissione per l’unità video. Quel nome può essere modi- 
ficato in qualsiasi momento dalla specifica IMAGE, Quando l'emissione dell'unità 
video è diretta ad una stampatrice 3262, il SSP controlla che la cinghia di stampa 
corrisponda al nome dell'immagine nella tabella di specifica della stampatrice. Il 
SSP viene fornito con parecchie immagini di cinghie di stampa; se per la cinghia 
non è possibile usare nessuna di esse, occorre crearne una propria, vedere Creat- 
ing Your Own Print Belt Members. Se la cinghia non corrisponde, il SSP visualiz- 
za un messaggio che istruisce l'operatore del sistema a cambiare la cinghia. 


La specifica IMAGE consente di predisporre una tabella di conversione per la 
stampatrice 3262 per ciascuna unità video o per ciascun lavoro nelia coda dei la- 


vori. Il lavoro avviato da una unità video o dalla coda lavori usa la tabella di con- 
versione del sistema a meno che non ne sia indicata una dalla specifica OCL IMA- 
GE. 


Posizione: la specifica OCL IMAGE può comparire ovunque tra le specifiche OCL. 


// IMAGE OE membro cinghia di stampa 


MEM 


XLATE,nome membro tabella di conversione 





MEMBER o MEM indica il nuovo membro di immagine della cinghia di stampa 
da usare. ll membro deve essere un membro origine della libreria di sistema 
(#LIBRARY). 


nome membro cinghia di stampa specifica il membro origine che contiene la 
nuova immagine della cinghia di stampa. Il SSP comprende i seguenti membri 
di cinghia di stampa: 


BELT48 
BELT48HN 
BELT64B 
BELT64C 
BELT96 
BELT188B 


Per informazioni sui caratteri inclusi in queste cinghie di stampa, vedere Cin- 
ghie di stampa 3262 in Appendice E. 
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XLATE specifica che verrà sostituita una tabella di conversione. Quando si stam- 


pano informazioni che comprendono caratteri minuscoli usando una cinghia 
di stampa diversa da BELT96 o BELT188B, le tabelle di conversione consen- 
tono di convertire tutti i caratteri minuscoli in maiuscoli. 


nome membro tabella di conversione specifica il membro origine nella libre- 
ria di sistema che contiene una tabella di conversione. Il SSP prevede le se- 
guenti tabelle di conversione: 


#96E48 Converte la serie a 96 caratteri in una cinghia di stampa 
a 48 caratteri. 


#96E64 Converte la serie a 96 caratteri in una cinghia di stampa a 
64 caratteri. 


#188E48 Converte la serie di 188 caratteri in una cinghia di stampa a 
48 caratteri 


#188E64 Converte la serie di 188 caratteri in una cinghia di stampa a 
64 caratteri. Quando è in effetto questa tabella di conver- 
sione, i caratteri !, ‘], e g su una cinghia di stampa da 64 


caratteri vengono battuti come spazi in bianco. 


#188E96 Converte la serie di 188 caratteri in una cinghia di stampa 
a 96 caratteri. Quando è in effetto questa tabella di conver- 
sione, i caratteri !, |, g,1n, e ® su una cinghia di stampa da 
96 caratteri vengono battuti come spazi in bianco. 


#188E188 Ripristina la conversione dei caratteri. 


Per informazioni sui caratteri convertiti in queste tabelle, vedere 7abe//e di 
conversione 3262. Per disattivare la conversione dei caratteri, specificare la 
tabella di conversione #188E188. 


Per specificare una tabella di conversione propria, if primo record nell'ambito 
del membro origine, deve essere nella forma: 


pp.nnn 


pp è una rappresentazione a 2 caratteri di un byte esadecimale che specifica 
la posizione del primo carattere da sostituire nella tabella di conversione. pp 
deve essere compreso tra esadecimale 40 e FE. 


nn è un numero da 1 a 3 caratteri che specifica il numero dei caratteri che 
vengono forniti come dati della tabella di conversione. il campo ammesso per 
questo valore è da 2 a 384. 


La seconda e le seguenti specifiche origine devono contenere rappresentazioni 
a 2 caratteri di ciascun byte esadecimale da sostituire nella tabella di conver- 
sione. Il numero dei caratteri deve essere uguale ai valore specificato in nnn 
e ciascuna rappresentazione deve avere un valore maggiore di o uguale a esa- 
decimale 40 e minore di o uguale a esadecimale FE. Eccetto che per l'ultimo record, 
il dato deve riempire completamente la lunghezza record specificata al momento 
della creazione della tabella di conversione. 
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Esempio 1 


Il membro per la cinghia di stampa BELT64C è in un membro origine della libreria 
di sistema denominato BELT64C. 


// IMAGE MEMBER, BELT6ÌC 


Esempio 2 


Specifica di una cinghia di stampa BELT64C e di una tabella di conversione 
#96E64. Ciò fa sì che l'emissione venga stampata usando una cinghia di stampa 
da 64 caratteri; qualsiasi carattere minuscolo viene convertito e stampato come 


carattere maiuscolo, 


// IMAGE MEMBER, BELT64C 
// IMAGE XLATE,#96E6Lh 


Esempio 3 
Specifica di una tabella di conversione usando un membro origine ALPHA. 
// IMAGE XLATE,ALPHA 
Il membro origine ALPHA dovrebbe contenere le seguenti righe: 


c1,6 
ETESE9 


C1 (il valore esadecimale per la lettera A), indica il primo carattere da sostituire 
e 6 specifica il numero di caratteri che vengono forniti. Come risultato, i carat- 
teri A, B e C, vengono rispettivamente cambiati in X, Y e Z (esadecimale E7, E8 


e E9). 


Creazione di propri membri di cinghie di stampa 


Se occorre usare una cinghia di stampa che non ha un membro di cinghia di 
stampa fornito dalla IBM, occorre crearne uno apposito. Il membro origine si 
compone di una forma speciale della specifica IMAGE (detta specifica membro 
IMAGE) e di una o più righe che indicano i caratteri sulla cinghia di stampa. 


La specifica del membro IMAGE ha il seguente formato: 













CHAR |, lunghezza dati 
HEX 


// IMAGE 








CHAR indica che la riga o ie diverse righe che seguono la specifica IMAGE sono 
in forma carattere, 


HEX indica che la riga o le diverse righe che seguono la specifica IMAGE sono 
in forma esadecimale. Vedere Cinghia di stampa 3262 per le forme esadeci- 
mali dei caratteri. 


Se la cinghia di stampa contiene caratteri che non possono essere immessi 
dalla tastiera, sì deve specificare HEX. 


lunghezza dati specifica il numero di caratteri da immettere. (Se è specificato 
hex come primo parametro, ciascun carattere sulla cinghia di stampa richie- 
de due numeri esadecimali). Per la stampatrice IBM 3262, ia lunghezza dei 
dati non deve superare 288 quando vengono immessi caratteri e non deve 
superare 576 quando vengono immessi numeri esadecimali. 


La riga o diverse righe di caratteri hanno il seguente formato: 

e |caratteri devono iniziare nella prima posizione. 

e Devono essere usate posizioni consecutive e i caratteri devono essere immessi 
nella sequenza in cui compaiono sulla cinghia di stampa. Per esempio, la se- 
quenza dei caratteri su una cinghia di stampa campione di 50 caratteri po- 
trebbe essere la seguente (questa informazione è inclusa con la cinghia di 
stampa): 


1234567890#a /STUVWXYZ& ,JKLMNOPQR-$*ABCDEFGHI+.'!?=> 


e Tutte le posizioni nella riga devono contenere caratteri prima che i caratteri 
possano essere continuati su una riga successiva. 
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Per esempio, per creare un membro di cinghia di stampa per la cinghia di stampa 
campione a 50 caratteri sopra indicata, occorrerebbe adottare una delle due for- 
me seguenti: 


// IMAGE CHAR,50 #% 
. 123k4567890#9/STUVWXYZ&,JKLMNOPQR-$*ABCDEFGHI+.'?=> 


oppure in forma esadecimale: 


// IMAGE HEX,100 
F1F2F3FhF5F6F7F8F9FOTBTC61E2E3E4E5E6E7ESE9506BD1D2D3DUD5DED7TDEDI 


605B5CC1C203C4C5C607c8C9LEUB7D6FBF6E 


Per creare effettivamente il membro, vedere Programma di utilità $SMAINT, Fun- 
zioni addizionali oppure il manuale Programma di Utilità per l'immissione di dati 
origine (SEU). 


SPECIFICA OCL INCLUDE 


La specifica OCL INCLUDE identifica un membro di procedura contenente spe- 
cifiche di controllo di programmi di utilità e OCL da inserire nel flusso di lavori. 
Se la procedura non è per terminali richiedenti multipli (MRT) oppure se non è 
stato specificato PDATA-YES quando è stato creato il membro di procedura, la 
specifica INCLUDE può passare parametri alla’ procedura. 


Se la procedura è del tipo MRT oppure se è stato specificato PDATA-YES quan- 
do è stato creato il membro di procedura, ia specifica INCLUDE può trasmettere 
soltanto DATI ad un programma. 


Per informazioni e considerazioni generali di programmazione sui programmi e le 
procedure MRT, vedere il manuale Concepts and Programmer's Guide. Per infor- 
mazioni sulla creazione di procedure, vedere il Capitolo 2, Creazione di proprie 
procedure. 


Si deve usare la prima forma della specifica INCLUDE' se il nome di procedura 
corrisponde all’identificatore di una specifica OCL. Per esempio, se il nome di pro- 
cedura è FILE, il formato seguente è quello corretto: 


// INCLUDE FILE FILEA,FILEB 
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Posizione: la specifica INCLUDE può essere disposta ovunque fra le specifiche 
OCL. 


nome procedura [}n0ne libreria | paraml,param2... 


dati programma 
*ALL 


oppure: 


// nome procedura [pnome Libreria] paraml,param2... 


dati programma 
*ALL 


oppure: 


// INCLUDE nome procedura [-none librerie | paraml,param2... 


dati programma 
*ALL 











nome procedura specifica il membro di procedura da richiamare. 


nome libreria specifica la libreria in cui cercare la procedura. Se è specificato un 
nome di libreria, la libreria viene esaminata e quindi viene esaminata la libre- 
ria di sistema (#LIBRARY). Se non viene immesso il nome di libreria, la ri- 
cerca viene effettuata nella libreria corrente e quindi in #LIBRARY. 


param1,param2, ... specifica i parametri per la procedura. ! parametri non sono 
ammessi se si tratta di una procedura MRT oppure se è stato specificato 
PDATA-YES quando è stato creato il membro di procedura. | parametri pos- 
sono essere o meno richiesti in relazione alla procedura alla quale sono pas- 


sati. 


Il numero di caratteri in un parametro non deve superare 128. Con una specifi- 
ca INCLUDE è possibile passare un massimo di 64 parametri separati da virgo- 
le. Per maggiori informazioni sui parametri di procedura, vedere ‘’Parametri di 
procedura”. 


Quando si immettono i parametri, è possibile battere fino a 512 caratteri. 
Per esempio, è possibile battere 32 parametri da 16 caratteri oppure 64 
parametri da 8 caratteri. În ogni caso il totale combinato di tutti i parametri 
non può superare i 1024 caratteri; questa lunghezza può essere ottenuta 
usando espressioni sostitutive e l’area dati locale, Vedere Continuazione delle 
righe di una ‘procedura per informazioni sul modo in cui continuare le righe 
di immissione per ottenere più di 120 caratteri. 
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dati 


Se il parametro inizia con un'apice (’) è considerato una stringa di caratteri e 
deve terminare pure con apice. | parametri che sono stringhe di caratteri pos- 
sono contenere qualsiasi carattere, compresi gli spazi in bianco incorporati e 
le virgole (,). Tutti i dati tra gli apici sono elaborati come un parametro. Gli 
apici di inizio e di fine non sono elaborati come parte del parametro. La lun- 
ghezza del parametro è impostata uguale al numero dei caratteri tra i due 
apici, 


Se un parametro non inizia con un’apice, qualsiasi altro apice incontrato nel 
parametro, è considerato come un dato e non come un delimitatore di strin- 
ga di caratteri. Se nel parametro deve essere incluso un’apice, deve essere spe- 
cificato sotto forma di due apici. Quanto segue mostra esempi di stringhe di 
caratteri come parametri: 


PROCA "il parametro 1l',PARAMETRO2,'"l''orologic','''X,x'!! 


I parametri passati alla procedura PROCA, sono: 


Parametro Contenuti 

1 il parametro 1 
2 PARAMETRO2 
3 l'orologio 

4 XX 


Quanto segue mostra esempi di apici come dati: 
PROCA X'EF,l'orologio 


| parametri passati alla procedura PROCA sono: 


Parametro Contenuti 
1 X'FF 
2 l'orologio 


programma specifica i dati e non i parametri da passare in occasione della 
prima operazione di lettura nel programma, | dati iniziano con il primo ca- 
rattere diverso dallo spazio in bianco che segue il nome di procedura e ter- 
minano con l’ultimo carattere diverso dallo spazio in bianco nella specifica, 
I dati vengono passati al programma in occasione delia prima operazione di 
immissione dall'unità video. (Il record di immissione del programma conter- 
rebbe questi dati). E’ possibile specificare fino a 508 caratteri usando la 
continuazione, Vedere Continuazione delle righe di una procedura per infor- 
mazioni sul modo in cui continuare le righe di immissione per più di 120 
Caratteri. 


*ALL specifica che tutti i 64 parametri devono essere passati dal livello di pro- 


cedura corrente alla procedura che viene richiamata. *ALL può essere spe- 
cificato soltanto nell’ambito di una procedura. Se viene specificato *ALL 
come solo parametro e viene immesso dalla tastiera o selezionato da un'op- 
zione di menù, viene visualizzato un messaggio di errore. Se viene specificato 
*ALL come uno dei parametri, viene trattato come un singolo parametro. 
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SPECIFICA OCL INFOMSG 


// INFOMSG 


La specifica OCL INFOMSG indica se devono essere visualizzati i messaggi informa- 
tivi. Per esempio, è possibile creare una procedura che usa parecchie procedure di 
sistema. Tutte le procedure di sistema emettono messaggi per indicare che sono in 
fase di esecuzione e tali messaggi possono essere motivo di confusione per alcuni 
operatori che stanno eseguendo programmi applicativi. 


Inoltre, un messaggio informativo inviato ad una unità video a distanza si traduce 
in un tempo di risposta più lungo in quanto lo schermo corrente viene salvato e 
quindi viene ripresentato di nuovo quando la procedura termina. Evitando che i 
messaggi informativi vengano visualizzati, è possibile diminuire il tempo necessa- 
rio per eseguire la procedura. Quando in una procedura viene indicata la specifica 
INFOMSG, essa rimane in atto fino a che non viene elaborata un'altra specifica 
INFOMSG o fino a che la procedura termina. Quando ia specifica INFOMSG 
viene immessa dalla tastiera, rimane in effetto fino a che non viene immessa una 
altra specifica INFOMSG o fino a che l'operatore non si scollega. 


Posizione: la specifica INFOMSG può essere disposta ovunque tra le specifiche 
OCL. La specifica OCL INFOMSG non può essere usata in una sessione CF, in 


un lavoro che viene eseguito dalla coda dei lavori o in un lavoro che è stato ri- 
chiamato (specifica OCL EVOKE). 





YES specifica che devono essere visualizzati i messaggi informativi. Se non viene 
specificato alcun parametro, si presume YES. 


NO specifica che i messaggi informativi immessi dalla specifica //* non devono 
essere visualizzati. 


Esempio 
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x 


Questo esempio mostra come è possibile visualizzare un messaggio informativo 
generico ed impedire che i messaggi emessi dalle procedure SAVE vengono visua- 
lizzati e quindi visualizzare un messaggio al termine della procedura. 


// *'Salvataggio dei file FILEl, FILE2, e FILE3'! 
// INFOMSG NO 

SAVE FILEl,,VOLOO1l 

SAVE FILE2,,VOLOO1 

SAVE FILE3, VOLOO1l 

// INFOMSG YES 

// * ‘Salvataggio completato! 


SPECIFICA OCL JOBO 


La specifica OCL JOBO. inserisce un lavoro nella coda dei lavori. La specifica 
— OCL JOBO può essere più utile per i lavori che non richiedono immissione o ri- 
sposta da parte dell'operatore oppure per i lavori la cui emissione non è richiesta 


da un successivo passo di lavoro, ll numero massimo di caratteri che è possibile 
immettere sulla specifica JOBO è 120, 


Posizione: la specifica JOBO può comparire ovunque tra le specifiche OCL. 





prlorltà in coda lavori, nome libreria snome procedura 
3 libreria corrente 





| peranì sparam2.. J 





priorità in coda lavori specifica la priorità in coda lavori (cioè l'ordine di elaborazione 
del lavoro dalla coda lavori). La priorità della coda lavori può essere indicata 
da qualsiasi numero da 0 a 5. Nella scelta del lavoro successivo il sistema ese- 
gue i lavori con numeri di priorità più elevata prima di quelli con numero di prio- 
rità più bassa. Per esempio, tutti i lavori con una priorità di 5 vengono eseguiti 
prima di qualsiasi altro lavoro nella coda. | lavori con la stessa priorità sono ese- 
guiti nell'ordine in cui sono stati inseriti nella coda lavori. | lavori con una priori- 
tà di coda lavori di 0, sono gli ultimi lavori eseguiti dal sistema. Se non è speci- 
ficata la priorità di coda lavori, viene assegnata la priorità 3 e la virgola indicata 
in questo parametro non deve essere specificata. 


nome libreria specifica la libreria per il lavoro. Il sistema cerca nella libreria spe- 
cificata e quindi nella libreria di sistema le procedure, i membri oggetto, i 
membri di messaggi e i tracciati video usati in questo lavoro. Se non è speci- 
ficato il parametro, si presume la libreria corrente. 


nome procedura specifica la procedura che deve essere inserita nella coda dei la- 
vori. 


param1,param2, ... specifica i parametri richiesti dalla procedura. E’ possibile in- 
dicare al massimo 120 caratteri usando la specifica OCL JOBO. 


Esempio 


Inserire la procedura PAYROLL che è disposta nella libreria PAYLIB, nella coda 
lavori con una priorità di coda lavori di 4. 


// J0BQ 4, PAYLIB, PAYROLL 
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SPECIFICA OCL LIBRARY 


La specifica OCL LIBRARY indica il nome della libreria corrente per ia sessione 
dell'unità video o per la durata di una procedura. La libreria corrente è quella 
nella quale il SSP cerca per prima i programmi indicati sulle specifiche OCL 
LOAD, le procedure, i menù, i membri di messaggi e i tracciati video. Se il SSP 


non trova il membro nella libreria corrente, cerca automaticamente nella libreria 


di sistema (#LIBRARY). 


Una libreria rimane corrente fino a che non viene elaborata un'altra specifica 
OCL LIBRARY o fino a che non termina la sessione dell'unità video. Se è usata 
la specifica LIBRARY in una procedura (e non viene specificato SESSION-YES), 
la libreria corrente viene modificata soltanto mentre viene eseguita quella proce- 
dura. Quando la procedura termina, la libreria che era corrente quando la proce- 
dura è iniziata, é di nuovo corrente. 


Una volta che viene specificata una libreria come corrente (quando l'operatore si 
collega al sistema oppure quando viene immessa una specifica OCL LIBRARY 
dalla tastiera), quella libreria rimane allocata all'unità video almeno fino a che 
non viene specificato una diversa libreria corrente o NAME-0. 


Se viene specificata una diversa libreria corrente oppure NAME-0, mentre l’unità 
video specificata sta ancora usando uno o più membri dalla precedente libreria 
corrente (ad esempio usando un menù da quella libreria), ia precedente libreria 
corrente rimane allocata all'unità video fino a che l’unità video non usa più mem- 
bri da quella libreria. Di conseguenza, talune funzioni come la procedura CON- 
DENSE, non possono essere eseguite sulla libreria, quantunque questa non sia 
più una libreria corrente sull'unità video. 

Quando viene interrotta una procedura, la libreria per la sessione è corrente du- 
rante la richiesta di interrogazione, La libreria che era corrente per la.procedura 
interrotta sarà di nuovo la libreria corrente quando la procedura viene ripresa. 
Per esempio, una procedura contiene la specifica seguente: 


// LIBRARY NAME-JOBLIB 


Se un programma nell’ambito della procedura viene interrotto, la libreria corrente 
per la sessione (non JOBLIB), rimarrà corrente durante la richiesta di interroga. 
zione. Per informazioni sull'interruzione di un programma, vedere il manuale 
Guida Operativa 


Se viene immessa la specifica OCL LIBRARY da uno schermo MENU, una o più 
delle opzioni sul menù visualizzato potrebbero non essere corrette in quanto le 
procedure corrispondenti a quelle opzioni non esistono nella nuova libreria cor- 
rente. 





Posizione: la specifica OCL LIBRARY può comparire ovunque tra le specifiche 
OCL salvo che tra una coppia di specifiche LOAD e RUN. ° 


0 YES 


// LIBRARY ea a ei [sesta li 


| 
] 





NAME specifica la libreria che sarà quella corrente. Se viene indicato NAME-0, 
da parte del sistema viene effettuata la ricerca soltanto nella libreria di si- 
stema (#LIBRARY). 


SESSION specifica se deve essere modificata la libreria di sessione. 


NO fa sì che la libreria corrente venga modificata. Se non viene specificato 
alcun parametro, si presume NO. La modifica rimane in effetto fino a che 
il lavoro non termina. 


YES fa sì che la libreria di sessione venga modificata nella libreria indicata 
nel parametro NAME (la libreria di sessione è la libreria in effetto operando 
dalla tastiera). La modifica rimane in vigore dopo il termine del lavoro cor- 
rente. (Essa dura fino a che non viene cambiata di nuovo o fino a che non 
termina la sessione). Se la specifica OCL viene immessa dalla tastiera, la li- 
breria corrente è la libreria di sessione; pertanto, il parametro SESSION non 
ha alcun effetto. 


Esempio 1 
La seguente specifica indica che una libreria MYLIB è quella corrente. 


// LIBRARY NAME-MYLIB 


Esempio 2 


La specifica OCL LIBRARY nella procedura seguente indica che una libreria de- 
nominata PAYLIB è quella corrente per la procedura. Il programma denominato 
PAYROLL e il membro di messaggi denominato PAYMSG, sono contenuti in 
quella libreria. 


// LIBRARY NAME-PAYLIB 
// MEMBER USER1l-PAYMSG 
// LOAD PAYROLL 

// FILE NAME-PAYFILE 
// RUN 
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SPECIFICA OCL LOAD 


La specifica OCL LOAD identifica un programma da eseguire. La specifica 
LOAD è la prima di una serie che definisce un passo di lavoro, DIRI 


Posizione: non è possibile immettere due specifiche OCL LOAD senza una 
specifica OCL RUN intermedia. 


// LOAD nome programma [none libreria] 





nome programma specifica il programma da caricare. ll programma denomi- 
nato è un membro oggetto di libreria, 


nome libreria specifica la libreria in cui cercare il programma. Se è specificato 
un nome di libreria, la ricerca viene effettuata in quella libreria e quindi 
nella libreria di sistema (#LIBRARY). Se non viene immesso il nome di 
programma la ricerca viene effettuata nella libreria corrente e quindi viene 
effettuata la ricerca in #LIBRARY. 


Esempio 1 


Nella seguente specifica LOAD, PAYROLL identifica un programma di paghe 
e stipendi, 


// LOAD PAYROLL 


= 
Esempio 2 
L'esempio che segue mostra una procedura campione memorizzata in una libreria 
denominata MYLIB, che esegue un programma denominato MYPROG. li pro- 
gramma visualizza messaggi da un membro di libreria denominato MESSAGES, 
che è memorizzato in una libreria denominata COMMLIB. 
// MEMBER USERI-MESSAGES, LIBRARY-COMMLIB 
// LOAD MYPROG,MYLIB 
// RUN 
Esempio 3 
L'esempio che segue mostra una procedura che esegue un programma denomina- 
to TEST. Il programma visualizza messaggi da un membro di messaggi denomina- 
to TESTMSG. Il membro di messaggi e il programma, sono entrambi memorizzati 
in una libreria denominata TESTLIB. 
// LIBRARY NAME-TESTLIB 
// MEMBER USER1-TESTMSG 
// LOAD TEST 
// FILE NAME-TEMP,LABEL-TEMP?WS? 3 RETAIN-J-BLOCKS-30 
// RUN 
en 
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SPECIFICA OCL LOCAL 


La specifica OCL LOCAL è usata per modificare un’area specificata nell'area dati 
locale dell'unità video. E’ possibile usare questa specifica per scambiare informa- 
zioni tra procedure, programmi, passi di lavoro e lavori. 


Esiste un'area dati locale per l’unità video per ciascuna unità video di comandi e 
per ciascuna procedura MRT in esecuzione. Ciascuna area dati locale dell'unità 
video è un'area di 5712 byte su disco che può essere usata per trasmettere infor- 
mazioni tra lavori, passi di lavoro, procedure e programmi eseguiti durante una 
sessione all'unità video. Per informazioni sull'uso dei dati dall'area dati locale 
dell'unità video per modificare una procedura, fare riferimento a Espressione 
?L'posizione,lunghezza‘? (Area dati locale). 


I{ SSP imposta automaticamente l’area dati locale a spazi in bianco all’inizio di 
una sessione è cioè quando l'operatore si collega al sistema. L'area dati locale può 
essere usata da tutti i lavori eseguiti durante la sessione. In ogni caso, un lavoro inse- 
rito nella coda dei lavori o un passo di lavoro rilasciato usa una copia dell’area dati 
locale così com'era quando il lavoro è stato inserito nella coda o quando il lavoro 
è stato rilasciato. 


Se viene usato il modo interrogazione (e cioè se l'operatore preme il taso 
ATTEN e sceglie l'opzione 1), i contenuti dell'area dati locale vengono salvati e 
quindi ripristinati quando termina il modo interrogazione. 
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Posizione: La specifica LOCAL può comparire ovunque tra le specifiche OCL. 


// LOCAL iù [.pamk-'carstteri | logi 


le *ALL 


,AREA- f USER 
SYSTEM 





Quantunque ciascun parametro sia facoltativo, deve essere specificato il parame- 
tro DATA, BLANK o AREA. 


OFFSET specifica la prima posizione nell’area dati locale dell'unità video da cam- 
biare. 


posizione può essere qualsiasi numero da 1 a 512. Se non viene immessa una 
posizione, si presume 1. . 


DATA specifica i dati che devono essere posti nell’area dati locale dell'unità 
video. 


‘caratteri’ deve essere racchiuso tra apici (‘). Se i caratteri contengono apici 
incorporati (ad esempio l'orologio), immettere l’apice incorporato come due 
apici (per esempio l’’oroiogio’). Il numero di caratteri è limitato dalla lun- 
ghezza massima della specifica OCL. 


BLANK specifica il numero di posizioni iniziando con la posizione indicata da 
OFFSET da impostare a spazi in bianco. 


lunghezza specifica il numero di posizioni da impostare a spazi in bianco. 


*ALL specifica che tutte le posizioni dopo quella indicata da OFFSET de- 
vono essere cancellate. 


Se vengono indicati BLANK e DATA sulla stessa specifica LOCAL, l’area 
dati locale viene per prima cosa cancellata e quindi in essa vengono inseriti 
i dati. 


AREA specifica quale area deve essere usata dalla specifica corrente LOCAL e 
da tutte le espressioni seguenti di sostituzione dell'area dati locale. 


USER specifica che deve essere usata l’area dati locale dell'utente. Se non 
è indicato AREA sulla specifica LOCAL, si presume LOCAL-USER. | pro- 
grammi su licenza e il SSP non influiscono su quest'area. 


SYSTEM specifica che deve essere usata l’area dati locale del sistema. Questa 
area è usata dai programmi su licenza e dal SSP. Qualsiasi dato che s'inserisce 
in quest'area può andare perso e può influenzare il modo in cui funzionano 
i programmi su licenza e il SSP. Pertanto, non si deve specificare SYSTEM. 
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Esempio 1 


La seguente specifica inserisce la parola PAYROLL nell'area dati locale dell'unità 
video iniziando nella posizione 18 (fino a 24). 


// LOCAL OFFSET-18,DATA-'PAYROLL' 


Esempio 2 


L'esempio che segue appare nell’ambito di una procedura e inserisce il valore del 
primo parametro di procedura nell’area dati locale iniziando aila posizione 12. 


// LOCAL OFFSET-12,DATA-'?12! 


Esempio 3 


Questo esempio cancella le posizioni da 1 a 8 dell’area dati locale e quindi inseri- 
sce il nome della procedura nelle posizioni da 1 a 8. 


// LOCAL DATA-'?PROC?!, BLANK-8 


Esempio 4 
Per cancellare l’intera area dati locale, immettere: 


// LOCAL BLANK-*ALL 
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SPECIFICA OCL LOG 


La specifica OCL LOG indica se le specifiche OCL in una procedura devono esse- 
re registrate sul file storico, cronologico, indipendentemente dall’indicatore di re- 
gistrazione cronologica, della specifica OCL nella procedura stessa. Ciò consente 
di creare procedure proprie con questo indicatore disattivato (per ottenere miglio- 
ri prestazioni), pur avendo le specifiche OCL registrate nel file storico, cronologi- 
co quando è necessario eseguire ricerce e correzione degli errori della procedura. 


Le opzioni dei menù del supporto di testi esplicativi e le opzioni dei menù dell'u- 
tente possono essere registrate sul file storico, cronologico specificando LOG ON. 
La- registrazione di queste opzioni può essere disattivata specificando LOG OFF. 


Tutti i comandi di procedura sono registrati sul file storico, cronologico, indipen- 
dentemente dalla regolazione della specifica OCL LOG e dall’attributo di registra- 
zione della procedura. 


Posizione: La specifica OCL LOG può essere disposta ovunque tra le specifiche 
OCL. Quando viene indicata in una procedura, essa rimane in effetto fino a che 
non viene elaborata un’altra specifica OCL LOG o fino a che la procedura non ter- 

ta mina. Quando la specifica LOG viene immessa dalla tastiera, essa rimane in effetto 
fino a che non viene immessa un’altra specifica OCL LOG, fino a che non viene 
immessa la procedura LOG oppure fino a che l'operatore non si scollega. 





ON indica che tutte le specifiche OCL devono essere registrate sul file storico, 
cronologico, indipendentemente dall'indicatore di registrazione della procedu- 
ra. Inoltre, sono registrate sul file storico, cronologico, le opzioni di menù. 


OFF indica che sul file storico, cronologico, non devono essere registrate specifi- 
che OCL, indipendentemente dall'indicatore di registrazione della procedura. 
La registrazione delle opzioni di menù è disattivata. 


NORMAL specifica che deve essere usato l'indicatore di registrazione della proce- 
dura. La registrazione delle opzioni dei menù è disattivata. 


Esempio 1 


_ Quando viene immesso questo esempio dalla tastiera, tutte le specifiche OCL ela- 
borate nella procedura sono registrate sul file storico, cronologico. 


// LOG ON 


Esempio 2 


Questo esempio mostra come far sì che vengano registrate le specifiche OCL sol- 
tanto dalle procedure PROC1 e PROC3. Le specifiche OCL per la procedura 
PROC2 non sono registrate. 


// LOG ON 

PROCI 

// LOG OFF 
PROC2 

// LOG ON 

PROC3 
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SPECIFICA OCL MEMBER 


La specifica OCL MEMBER specifica il nome dei membri di messaggi correnti da 
usarsi per i programmi e le procedure. ll sistema ottiene i messaggi da visualizzare 
dai membri di messaggi correnti. | membri specificati rimangono correnti fino a 
che il sistema non elabora un’altra specifica OCL MEMBER dall'unità video o 
fino a che non termina la sessione all'unità video. Se in una procedura viene usa- 
ta la specifica OCL MEMBER, i membri correnti sono modificati soltanto mentre 
la procedura viene eseguita. Quando la procedura termina, i membri di messaggi 
che erano correnti quando la procedura è iniziata sono di nuovo correnti. 


Nella specifica MEMBER sono indicati quattro tipi di membri di messaggi: 
USER1, USER2, PROGRAMI1 e PROGRAM2. 


I messaggi di primo e secondo livello del programma utente sono richiamati rispetti- 
vamente dai membri USER1 e USER2. | messaggi di primo livello possono conte- 
nere al massimo 75 caratteri. | messaggi di secondo livello possono contenere al 
massimo 225 caratteri. 


Per informazioni sulla creazione dei membri di messaggio, vedere la Procedura 
CREATE. 


I messaggi di primo e di secondo livello dei programmi su licenza IBM {salvo 
SSP), sono richiamati rispettivamente dai membri PROGRAM1 e PROGRAM2, 
| programmi utente non devono usare i membri di messaggio di primo e di secondo 
livello dei programmi su licenza. 


Posizione: la specifica OCL MEMBER può comparire ovunque tra le specifiche 
OCL. 


// MEMBER esa nome membr Ù; sÙ di membr Ù; 
O O 


I ,LIBRARY-nome Libreria] 


,PROGRAMI- 1° sua , PROGRAM2- (25 membro 


O 0 





USER1 specifica il nome de! membro oggetto usato per i messaggi di primo livel- 
lo per i programmi e le procedure. li membro di messaggi USER1 viene an- 
che usato con la specifica //*, la specifica //** e le espressioni di sostituzione 
della procedura. Se viene specificato 0 come nome del membro, non c'è 
membro corrente di messaggi di primo livello dell'utente. 


USER2 specifica it nome del membro oggetto usato per i messaggi di secondo 
livello per i programmi e le procedure. Se viene specificato 0 come nome 
membro, non c'è membro di messaggi corrente di secondo livelto dell'utente. 


LIBRARY specifica la libreria in cui cercare i membri di messaggi. Se viene speci- 
ficato il nome di una libreria, la ricerca viene effettuata in quella libreria e 
quindi nella libreria di sistema (#LIBRARY). Se non viene immesso un nome 
di libreria, la ricerca viene effettuata nella libreria corrente e quindi nella li- 
breria di sistema (#LIBRARY). 


PROGRAMI1 specifica il nome del membro oggetto usato per i messaggi di primo 
livello dei programmi su licenza IBM (salvo SSP). Non occorre specificare 
questo parametro nelle procedure. 


PROGRAM2 specifica il nome del membro oggetto usato per i messaggi di secon- 


do livello dei programmi su licenza IBM (salvo SSP). Non occorre specificare 
questo parametro nelle procedure. 
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Esempio 1 
In questo esempio: la specifica //* fa visualizzare un messaggio. Dal membro og- 
getto di messaggi di primo livello denominato MESSAGES viene visualizzato un 
messaggio con un codice identificazione messaggio di 0006. 


// MEMBER USERI-MESSAGES 
/} * 0006 


Esempio 2 


L'esempio che segue mostra una procedura campione, memorizzata in una libreria 
denominata MYLIB, che esegue un programma denominato MYPROG. ll pro- 
gramma visualizza messaggi da un membro di messaggi denominato MESSAGES, 


che è memorizzato in una libreria denominata COMMLIB. 


// MEMBER USERl-MESSAGES,LIBRARY-COMMLTB 


// LOAD MYPROG 
// RUN 
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SPECIFICA OCL MENU 


La specifica OCL MENU fa sì che venga visualizzato un dato menù quando il la- 
voro che contiene la specifica OCL MENU termina. 


Posizione: La specifica MENU può comparire ovunque tra le specifiche OCL. 


// MENU nome men |,nome Libreria] 





nome menù specifica il menù da visualizzare al termine del lavoro e può conte- 
nere da 1 a 6 caratteri. 


nome libreria specifica la libreria contenente il MENU. Se non viene specificato 
alcun nome di libreria, il sistema cerca il menù nella libreria corrente e quin- 
di nella libreria di sistema (#LIBRARY). La libreria specificata diventa la li- 
breria. di sessione. Se la specifica MENU si trova nell'ambito di una procedu- 
ra, la libreria corrente per la procedura non viene influenzata. 


Esempio 1 


In questo esempio la specifica OCL MENU fa sì che venga visualizzato un menù 
denominato DAILY, che risiede nella libreria corrente quando termina il lavoro 
contenente la specifica MENU. 


// MENU DAILY 


Esempio 2 
In questo esempio, la specifica OCL MENU fa sì che venga visualizzato un menù 
denominato PAYROLL contenuto in una libreria denominata PAYLIB quando il 


lavoro contenente la specifica OCL MENU termina. Ai termine del lavoro, PAY- 
LIB diventa ia libreria corrente e la libreria di sessione. 


// MENU PAYROL,PAYLIB 
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583.1 


SPECIFICA OCL MSG 


La specifica OCL MSG invia un messaggio alia console di sistema, ad una specifica unità 
video, ad uno specifico operatore di unità video, o a tutte le unità video. 

1 messaggi ricevuti da una unità video o operatore vengono inseriti nel file messaggi 
di sistema (# MESSAGE). Dopo l'esecuzione di un IPL, i messaggi che erano stati inviati 
ad uno specifico operatore vengono rimossi dal file dei messaggi. Vengono rimossi an- 
che i messaggi ormai vecchî di più di sette giorni. 

Poichè il file messaggi è aggiornato durante un IPL, la specifica OCL MSG non è consen- 
tita nella procedura #STRTUP1, che richiede il sistema dedicato per elaborare lavori 
durante l’IPL. 


La procedura MSGFILE può essere utilizzata per: 

e Definire l'ampiezza e la posizione del file messaggi. 

e Listare le unità video e gli utenti che hanno messaggi nel file messaggi. 
e Rimuovere messaggi dal file messaggi. 

Per maggiori informazioni vedere la Procedura MSGFILE. 


Se un operatore è collegato ad una unità video nel momento in cui viene inviato un mes- 
saggio, viene inviato un segnale di allarme e si accende la spia luminosa di messaggio 
in attesa. Fino ad un massimo di 25 messaggi possono rimanere in attesa su ciascuna 
unità video. Se si compie un tentativo di inviare un messaggio quando se ne hanno 25 
in attesa, i messaggi non vengono inseriti nel file messaggi e l'operatore o l’unità video 
non possono ricevere messaggi in quel momento. 


Se un operatore è collegato a più unità video nel momento in cui viene inviato un mes- 
saggio ad una specifica unità video, viene inviato un segnale di allarme acustico e si 
accende la spia luminosa, di messaggio in attesa su tutte le unità video collegate. Il 
messaggio viene visualizzato sulla prima unità video che richiede il messaggio. 
Dopo che il messaggio è stato visualizzato la spia luminosa di messaggio in attesa si 
spegne su tutte le unità video. 


Se un operatore è collegato a nessuna unità video, quando il messaggio viene invia- 
to ed esiste una entrata nel file di identificazione utenti, quel messaggio viene posto 
nel file dei messaggi. ll messaggio viene visualizzato quando l'operatore si collega ad 
una unità video. Se l'operatore non ha una entrata nel file di identificazione utenti, viene 
avvertito chi ha spedito il messaggio che quel messaggio non può essere inoltrato. 


pre 


// MSG 


id terminale |,testo messaggio 
id utente 
ALL 





id terminale specifica l'ID dei terminale dell'unità video alla quale il messaggio 
deve essere inviato. Il comando STATUS WORKSTN può essere usato per 
determinare gli ID delie unità video. Se non è specificato il primo parametro, 
il messaggio viene inviato allo schermo CONSOLE della console di sistema. 
Se viene specificato l'ID del terminale delia console di sistema, il messaggio 
viene inviato allo schermo dei comandi della console di sistema. 


id utente specifica l'ID dell'utente da 1 a 8 caratteri che identifica l'operatore al 
quale deve essere inviato il messaggio. Ciascun operatore di unità video im- 
mette un ID dell'utente quando si collega al sistema. ll comando STATUS 
WORKSTN può essere usato per determinare l'ID dell'utente. Se viene speci- 
ficato l'ID dell'utente dell'operatore di sisterna, il messaggio viene inviato al 
video comandi delia console di sistema. 


ALL specifica che il messaggio deve essere inviato a tutte le unità video. 


testo messaggio specifica il messaggio da inviare. E' possibile immettere un mas- 
simo di 75 caratteri alfanumerici o speciali. 


Esempio 


In questo esempio viene eseguita o richiamata una-procedura dalla coda di lavori 
e l'operatore desidera sapere quando la procedura termina. La specifica OCL 
MSG al termine della procedura, informa l'operatore all'unità video quando la 
procedura termina. 


// LOAD PROGRAMI 
// FILE NAME-FILEl 

// RUN 

// MSG ?WS?,PROGRAM1 IS COMPLETE 


?WS? è un'espressione che fa sì che {"ID del terminale dell'unità video che ha in- 
serito la procedura nella coda dei lavori venga sostituito nella specifica MSG. Per in- 
formazioni sull’espressione di sostituzione vedere Espressioni di sostituzione. 
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// NOHALT 


SPECIFICA OCL NOHALT 


La specifica OCL NOHALT indica il livello di gravità di riposta automatica per il 
sistema, un lavoro o un passo di lavoro. Ciò consente di avere messaggi con valori 
di risposta automatica cui si deve dare risposta da parte del sistema anzichè ri- 
chiedere all'operatore di immettere la risposta ad un messaggio di errore. Ciò è 
utile quando si sta lavorando sul sistema senza un operatore, ad esempio, durante 
la notte. 


Per ulteriori informazioni sulla risposta automatica, vedere la Procedura RESPON- 
SE. 


Posizione: la specifica OCL NOHALT può essere disposta ovunque tra le specifi- 
che OCL. 


Se NOHALT viene immessa dalla tastiera e il secondo parametro non è specifica- 
to, rimane in effetto fino a che non viene immessa un'altra specifica OCL NO- 
HALT o fino a che l'operatore non si scollega dal sistema. Se è specificata in un 
lavoro e non è specificato il secondo parametro, rimane in effetto fino a che non 
viene elaborata un'altra specifica NOHALT o fino a che il lavoro termina. 


livello di gravità, |JOB 
SESSION 
SYSTEM 


livello di gravità specifica il livello di gravità di risposta automatica. E’ possibile 
immettere 0, 1, 2,30 4. ; 


O Zero specifica che ai messaggi non si deve rispondere automaticamente. 
Se viene visualizzato un messaggio, l'operatore deve immettere una rij- 
sposta a quel messaggio. Quando è specificato 0, la risposta automatica 
è disattivata. 


1 Specifica che il sistema deve rispondere automaticamente a qualsiasi 
messaggio avente un livello di gravità di 1. 


2 Specifica che il sistema deve rispondere automaticamente a qualsiasi mes- 
saggio avente un livello di gravità di 1 02. 


3 Specifica che il sistema deve rispondere automaticamente a qualsiasi mes- 
saggio avente un livello di gravità di 1,203. 


4 Specifica che il sistema deve rispondere automaticamente a qualsiasi mes- 
saggio avente un livello di gravità di 1, 2,3 0 4. 
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JOB specifica il livello di gravità da adottare per il lavoro. Il livello specificato 


rimane in atto fino a che il lavoro termina o non viene modificato da: 
e Un'altra specifica OCL NOHALT 
e Una procedura NOHALT 


Quando la specifica NOHALT è nell’ambito di una procedura e non viene in- 
dicato secondo il parametro, si presume JOB. Se viene immessa la specifica 
NOHALT dalla tastiera e viene indicato JOB, il secondo parametro viene 
ignorato e per la sessione viene impostato lo stato NOHALT. 


SESSION specifica il livello di gravità da usare per la sessione all'unità video. Il 


livello specificato rimane in effetto ‘fino a che la sessione all'unità video non 
termina o non è modificata da: 


e Un'altra specifica OCL NOHALT 
e Una procedura NOHALT 


Quando viene immessa la specifica NOHALT dalla tastiera e non viene speci- 
ficato alcun parametro, si presume SESSION. 


SYSTEM specifica se il livello di gravità deve stabilire il livello di gravità di rispo- 


sta automatica del sistema e il livello di gravità per l’unità video. Il livello di 
gravità di sistema stabilisce il livello di gravità anche per le altre unità video 
che si collegano dopo che è stato elaborato il parametro SYSTEM; le altre 
unità video che erano già collegate non sono influenzate. 


Per stabilire il livello di gravità di sistema prima che qualisiasi operatore possa 
collegarsi al sistema, includere la specifica NOHALT nelia procedura di avvia- 
mento di caricamento del programma iniziale (IPL) #STRTUP1. Vedere Pro- 
cedura #STRTUP1 per ulteriori informazioni. 


Se è attiva la riservatezza mediante parola d'ordine, SYSTEM può essere spe- 
cificato soltanto da un operatore avente la classificazione di operatore di si- 
stema o più elevata. Se non è attiva la riservatezza mediante parola d'ordine, 
SYSTEM può essere specificato soltanto dalla console di sistema. 


Se la specifica NOHALT è nella procedura ed è specificato SYSTEM il livello specifi- 
cato ha effetto immediatamente ad eccezione di quelle unità video che hanno lavori 
in esecuzioni. 


Esempio 1 


Per stabilire un livello di gravità di risposta automatica di 3 per l’intero sistema, 
occorre creare una procedura denominata #STRTUPI1 che potrebbe contenere la 
seguente specifica: 


// NOHALT 3, SYSTEM 


Esempio 2 


Per stabilire un livello di gravità di risposta automatica di 3 per il programma 
Payrol! è possibile specificare quanto segue nella procedura Payroll: 


// NOHALT 3 
// LOAD PAYROLL 
// FILE NAME- EMPLOY,DISP_OLD 


// RUN 


SPECIFICA OCL OFF 


La specifica OCL OFF scoliega un operatore dal sistema terminando così una ses- 
sione all'unità video. Dopo il termine della sessione, compare lo schermo di colle- 
gamento sull'unità video. 


I messaggi nella coda di messaggi per l'unità video sono visualizzati al momento 
dello scollegamento a meno che su un terminale a distanza non si specifichi OFF 
DROP (se non vengono visualizzati, rimangono nella coda e possono essere visua- 
lizzati successivamente). 


La specifica OCL OFF non può essere usata nel modo interrogazione o in una 
procedura per terminali richiedenti multipli (MRT). Essa non può essere usata in 
una sessione ICF, in un lavoro che viene eseguito dalla coda lavori o in un lavoro 
che è stato richiamato (specifica OCL EVOKE). 


Posizione: la specifica OCL OFF può comparire ovunque tra le specifiche OCL 
salvo tra le specifiche OCL LOAD e RUN. 





DROP e HOLD si applicano soltanto alle unità video a distanza. Esse sono igno- 
rate per le unità video che non sono a distanza e cioè per le unità video locali. 


DROP specifica che il collegamento della linea di comunicazione per un terminale 
a distanza su una linea commutata deve essere lasciato cadere (cioè scolle- 
gato). Lo schermo di collegamento non compare. Per contro, viene visualizza- 


to un messaggio indicante che lo scollegamento è riuscito. Se non viene im- 
messo un parametro per una unità video a distanza, si presume DROP. 


La linea non verrà lasciata cadere fino a che tutti i terminali su quella linea 
non hanno eseguito la rispettiva elaborazione. 


HOLD specifica che il collegamento della linea di comunicazione deve essere 


mantenuto (cioè la linea deve rimanere collegata) e deve essere visualizzato 
lo schermo di collegamento per un terminale video su una linea commutata. 


Esempio 


Nell'esempio che segue, una procedura esegue il programma LAST da un'unità 
video e al termine del lavoro, scollega l'utente dal sistema. 


// RUN 

// LOAD LAST 
// RUN 

* 


// OFF 
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SPECIFICA OCL POWER 
La specifica OCL POWER consente di spegnere il sistema. Quando si incontra 
OCL POWER sul sistema non possono essere eseguiti programmi. Se ci sono pro- 
grammi in esecuzione, la specifica OCL POWER viene ignorata. 


La specifica OCL POWER non può essere usata nel modo interrogazione, 


Posizione: La specifica OCL POWER può comparire ovunque tra le specifiche 
OCL salvo che tra le specifiche OCL LOAD e RUN. 


/ | POWER OFF 
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OFF specifica che il sistema deve essere spento immediatamente. ll parametro 
OFF è indispensabile. 


Esempio 


Nell'esempio che segue, le specifiche OCL WAIT e POWER OFF vengono usate 
insieme per effettuare automaticamente una copia di riserva notturna dei file 
principali e quindi spegnere il sistema. 


* Procedura copia di riserva notturna 

* 

* Attendere fino alle 6:00 pm prima di iniziare la copia 
e la sequenza di spegnimento. 

// WAIT TIME-180000 

* 


* Allocatre l'unità a minidischi 
// ALLOCATE UNIT-I1,CONTINUE-YES 
* 


* Salvare file anagrafici su minidisco 
SAVE CUSTMAST,,,VOLOO1,M1l 
SAVE ITEMMAST,,,VOLOO1,M1 
SAVE ACCIMAST,,,VOLOO1,Ml 


SAVE SHIPMAST,,,VOLOO1,M1 
* 








* Iniziare sequenza POWER OFF 

// TAG PWRLOOP 

// POWER OFF 

* Se POWER OFF non riesce, 
attendere l minuto e riprovare. 

// WAIT INTERVAL-000100 

// GOTO PWRLOOP 


Poiché il sistema ignora la specifica POWER OFF quando non può essere sicura- 
mente elaborata (per esempio quando è in esecuzione un altro lavoro), occorre 
una iterazione GOTO e TAG se la specifica POWER non riesce. Viene inclusa 
la specifica OCL WAIT per impedire che il sistema riprovi costantemente la spe- 
cifica POWER, il che aumenterebbe inutilmente la quantità di lavoro che il siste- 
ma sta facendo. 


Notare che questa procedura richiederebbe un caricatore di minidischi nell’ali- 
mentatore M1.. li caricatore dovrebbe essere in posizione prima delle 6:00 p.m. 


SPECIFICA OCL PRINTER 


La specifica OCL PRINTER identifica, e controlla l'emissione per, un file di 
stampa creato da uno o più passi di lavoro. La specifica OCL PRINTER può es- 
sere usata per apportare le seguenti modifiche ad un file di stampa: 


La stampatrice da usare per l'emissione stampata 

Il numero di righe da stampare per pagina 

La densità di stampa verticale (righe per pollice) 

La densità di stampa orizzontale {righe per pollice) 

Il numero di modulo da usare 

Il numero di copie dell'emissione di stampa differita da stampare 

Se l'emissione stampata deve essere differita 

Se il file di stampa deve essere continuato con i passi di lavori seguenti 
La priorità dell'emissione di stampa differita 

L'attività del file di stampa differita 


Se l'operatore deve allineare i moduli nella stampatrice prima di iniziare 
la stampa 


Se la stampa dell'emissione differita può iniziare prima che il passo di lavoro 
sia completato 


Se l'emissione stampata deve essere conservata sul file di stampa differita 
dopo la stampa. 


La percentuale dell'emissione da una stampatrice 5219 deve essere allineata a destra. 


Il numero di identificazione della ruota di stampa da usarsi con la stampatrice 
5219 o il numero di identificazione della fonte da usarsi con la 4224. 


Se deve essere stampata l'emissione con qualità finale. 


Se deve essere inviata la fine del messaggio formati. 
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Posizione: La specifica OCL PRINTER può comparire ovunque tra le specifiche 
OCL. Può essere prevista una specifica OCL PRINTER per ciascun file di stampa 
usato dal passo di lavoro. Se non viene usata la specifica OCL PRINTER, il SSP 
usa i valori assunti per difetto della specifica PRINTER quando stampa l’emissio- 
ne. | valori assunti per difetto possono provenire dalla configurazione del sistema, 
dalla procedura PRINT, dalla procedura LINES, dalla procedura SET e dalla spe- 
cifica OCL FORM. 








/} PRINTER | NAME- fnome file ,DEVICE-fid stanpatrice) 
$SYSLIST SYSTEM 


| stanes-rigne per pegine| sLPI-{U ,CPI-f10 
- 6 15 
8 


| sFoRKSNO-nunero nodulo] ,ALIGN- i ,EPOOL- Li 
NO NC 


, COPIES- LA; , CONTINUE- { sai ,PRIORITY-! 
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SHIFT TG 
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NAME specifica il nome che il programma usa per fare riferimento al file. Il no- 
me può essere qualsiasi combinazione di caratteri (numerici, alfabetici e spe- 
ciali) salvo le virgole (,), gli apici ('), e gli spazi in bianco. | punti interroga- 
tivi (2), le barrette (/), i segni di uguale (=), i segni di maggiore (>) e i trat- 
tini di divisione sillabica (-), devono essere usati con cautela in quanto hanno 
‘significati speciali nell’ambito delle procedure. ll primo carattere del nome 
file deve essere alfabetico (da A a Z, #, $ o @). Il numero dei caratteri in 
un nome file non deve superare 8. 


Quando la specifica OCL PRINTER non è inserita tra una coppia di speci- 
fiche OCL LOAD e RUN e viene indicato il parametro CONTINUE, non è 
possibile specificare il parametro NAME. 


$SYSLIST indica che ia specifica PRINTER controllo l'emissione di lista di 
sistema. Per informazioni sull'emissione di lista di sistema, vedere la Specifi- 
ca OCL SYSLIST. 


Se il parametro NAME non corrisponde ad un nome file specificato nel pro- 
gramma, per la stampa dell'emissione il SSP userà i valori assunti per difetto 
della specifica PRINTER. 


Nota: $SYSLIST è ignorato se è attivato il modo di ricerca e correzione 
degli errori. Per ulteriori informazioni, fare riferimento alla Specifica OCL 
DEBUG. 


DEVICE specifica la stampatrice da usare per il file di stampa. 


id stampatrice specifica 1°ID di terminale della stampatrice da usare. E’ possi- 
bile usare il comando STATUS WORKSTN per determinare gli ID di stampa- 
trice. 


SYSTEM specifica che deve essere usata. la stampatrice di sistema. 
Se non viene specificato DEVICE, si applicano le seguenti condizioni: 


e Se viene specificato NAME-$SYSLIST, la specifica OCL PRINTER sosti 
tuisce temporaneamente l'impostazione dell'unità di lista del sistema. Per 
esempio, se l'unità di lista di sistema corrente è CRT, l'emissione viene 
stampata invece di venire visualizzata. 


e Se è specificato un nome file diverso da $SYSLIST è la procedura è una 
procedura per terminali richiedenti multipli (MRT), l'emissione di stam- 
patrice viene inviata alla stampatrice di sistema. 


e Se il passo di lavoro contenente la specifica PRINTER viene rilasciato, 
richiamato o inserito sulla coda dei lavori, l'emissione stampata viene in- 
viata alla stampatrice specificata durante la configurazione del sistema. 
L'emissione viene inviata alla stampatrice di sessione o alla stampatrice 
di sistema. 


e Se il passo di lavoro viene eseguito come procedura per terminale richie- 


dente singolo, l'emissione di stampatrice viene inviata alla stampatrice 
di sistema. 
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LINES specifica il numero di righe stampate per pagina. Può essere qualsiasi nume- 


ro da 0 a 112. Se non è specificato LINES viene usato il numero di righe impo- 
stato precedentemente da una specifica OCL FORMS, dalla procedura LINES 
o dalla procedura PRINT. Se in un programma è specificato il numero di righe 
per pagina, viene usato il valore del programma. Se non è stato impostato il 
numero di righe per pagina durante la sessionem viene usato il valore specifi- 
cato per l’unità video durante la configurazione del sistema o assegnato dalla 
procedura SET o dal programma di utilità $SETCF. 


Per i programmi di utilità SSP e per la maggior parte dei programmi scritti 
dall'utente, la stampatrice salta alla successiva pagina dopo aver stampato 
6 righe in meno del numero di righe specificato. Per esempio, se viene spe- 
cificato. LINES-66, la stampatrice salta ad una nuova pagina dopo aver stam- 
pato la riga 60. Inoltre, la stampa inizia alla riga 6 della pagina successiva. 
Pertanto, se si specificano 66 righe per pagina, in realtà si ottengono 54 righe 
di emissione stampata per pagina (66 — 12 = 54). Se è specificato LINES-13, 
viene stampata una riga per pagina. Quando vengono specificate 12 righe o 
meno per pagina, la stampa si verifica su una sola riga per ogni pagina. 


Per le operazioni di stampa dai programmi, il SSP indica una condizione di 
eccedenza della stampatrice quando vengono stampate 6 righe in meno del 
numero specificato (a meno che il programma non usi un altro valore). 


LPI (righe per pollice) specifica la densità verticale di stampa da usare per l'emis- 


sione stampata dalla sessione dell'unità video. | valori che possono essere spe- 
cificati sono 4, 6 e 8. Se l'emissione viene stampata su una stampatrice diver- 
sa dalla 4224, 5225 o 5224, il parametro LPI è ignorato. 


Se non è specificato LPI il sistema usa il valore LPI ‘impostato precedente 
mente da una specifica OCL FORMS, da una procedura LINES o da una 
. procedura PRINT. Se non è specificato il parametro LPI e il numero di righe 
per pollice non era stato precedentemente impostato durante la sessione, il 
sistema usa il valore specificato quando la stampatrice è stata configurata (4, 
6 o 8). (Poichè l'emissione può essere inviata su qualsiasi stampatrice dal file di 
stampa differita, il valore di configurazione assunto viene determinato al momento 
della stampa effettiva non nel file di stampa differita). Se non è stato specificato 
alcun valore LPI al momento della configurazione della stampatrice, il valore LPI 
è impostato tramite il pannello dell'operatore della stampatrice. 


CPI (caratteri per pollice) specifica la densità orizzontale. da usare per l'emissione 


stampata. | valori che possono essere specificati sono 10 o 15. Se viene usa- 
to CPI-15, l'emissione deve essere stampata su una stampatrice 4214, 5225 
o 5224. Se viene tentato l’uso di CPI-15 su un’altra stampatrice, viene visua- 
lizzato un messaggio e l'operatore che controlla la stampatrice può cancellare 
il messaggio o continuare la stampa. CPI viene ignorato se l'emissione viene 
stampata su una stampatrice 5219 o 4224. 


Se non viene specificato CPI, viene usata la densità di stampa CPI precedentemen- 
te impostata da una specifica FORMS, da una procedura LINES o da una procedura 
PRINT. Se non è stato specificato alcun valore CPI, il valore è determinato da quello 
specificato al momento della configurazione del sistema (10 o 15). (Poichè l'emis- 
sione può essere inviata su qualsiasi stampatrice dal file di stampa differita, il valo- 
re di configurazione assunto viene determinato al momento della stampa effettiva 
non nel file di stampa differita). Se durante la configurazione della stampatrice 
non era stato assegnato nessun valore CPI, questo viene impostato tramite il 
pannello dell'operatore della stampatrice se questa supporta il CPI. 


FORMSNO specifica il numero di modulo da usare. il numero di modulo puo ey 


sere qualsiasi combinazione con un massimo di 4 caratteri salvo le virgole (,), 
gli apici ('), e gli spazi in bianco. In ogni caso, occorre usare con cautela i 
punti di domanda (?), le barrette (/), i segni di uguale (=), i segni di maggio- 
re di (de i trattini di divisione sillabica (-) in quanto hanno speciali signifi- 
cati nell’ambito delle procedure. 


Se non è specificato FORMSNO, viene usato il numero di modulo impostato 
precedentemente da una specifica FORMS. Se il numero di modulo non era 
impostato durante la sessione, viene usato il numero di modulo specificato 
per l’unità video durante la configurazione del sistema o quello assegnato dal- 
la procedura SET o dal programma di utilità $SETCF. 


ALIGN consente all'operatore che controlla la stampatrice di allineare i moduli 
nella stampatrice prima che inizi la stampa dell'emissione per il passo di lavo- 
ro. Se viene specificato il parametro ALIGN, qualsiasi indicatore di allinea- 
mento usato nel programma viene ignorato. Se non viene specificato ALIGN, 
viene usato l'indicatore di allineamento specificato nel programma (even- 
tuale). ALIGN è ignorato se l'emissione è stampata su una stampatrice 4224 
poiché quest’ultima compone e stampa i dati della pagina non una riga alla volta. 


YES specifica che il sistema deve stampare la prima riga dell'emissione e vi- 
sualizzare un messaggio. L'operatore quindi può allineare i moduli e quindi: 


» Scegliere un'opzione che provochi la stampa di una riga e la rivisualizza- 
zione del messaggio di allineamento. 


e Scegliere un'opzione che provochi la continuazione della stampa con il 
resto dell'emissione. 


NO specifica che il sistema deve stampare l'emissione senza consentire che i 
moduli vengano allineati. 


SPOOL indica se l'emissione della stampatrice deve essere differita. 


YES indica che l'emissione deve essere differita. 


NO indica che l'emissione non deve essere differita e che la stampatrice usata 
nel parametro DEVICE deve essere assegnata al lavoro o al passo di lavoro. 
Se fa stampatrice non è disponibile, viene visualizzato un messaggio. 


Se è stato scelto il differimento durante la configurazione del sistema, si pre- 
sume SPOOL-YES, altrimenti, il parametro SPOOL viene ignorato. 


COPIES specifica il numero di copie dell'emissione di stampa differita da stampa- 
re per il passo di lavoro. E' possibile specificare qualsiasi numero da 1 a 255. 
Se non viene specificato COPIES, si presume 1. Il parametro COPIES interes- 
sa soltanto l'emissione in SPOOL. 


CONTINUE specifica se l'emissione stampata deve continuare e cioè se l’emissio- 
ne stampata da questo passo di lavoro e dai passi di lavoro successivi, deve 
essere considerata come un singolo passo di stampa. | parametri CONTINUE 
e NAME possono essere specificati soltanto insieme quando la specifica 
PRINTER è inserita tra le specifiche OCL LOAD e RUN. 


YES specifica che l'emissione di stampa per una stampatrice specificata deve 
continuare nei seguenti passi di lavoro. ll parametro DEVICE specifica la 
stampatrice la cui emissione deve essere continuata. 


La stampa continua fino a che non viene elaborata un’altra specifica PRIN- 
TER contenente CONTINUE-NO per quell’unità o fino a che il lavoro non 
termina. Ciò consente di raggruppare l'emissione di parecchi passi di lavoro 
anzichè al limite avere l'emissione di ciascun passo di lavoro mescolata con 
l'emissione di altri lavori sul sistema. 


Nota: Si verifica un’espulsione di pagina tra l'emissione di ciascun passo di 
lavoro. ; 


Se l'emissione della stampatrice viene differita, l'entrata del file di stampa 
differita associata con l'emissione di stampatrice, viene lasciato aperto. Se l’e- 
missione della stampatrice non viene differita e cioè se l'emissione viene in- 
viata direttamente ad una stampatrice, la stampatrice rimane allocata al la- 
voro. 
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Se due o più file di stampa nello stesso passo di lavoro fanno riferimento al- 
la stessa stampatrice, può continuare soltanto uno dei file di stampa del 
passo di lavoro. Se viene usata la stampa differita, gli altri file di stampa 
sono inseriti sul file di stampa differita come entrate separate. Il file di stam- 
pa che continua è determinato da: 


e Se è indicata una specifica OCL PRINTER per la stessa unità di stampa- 
trice, il sistema continua il passo di stampa rappresentato dalla prima 
specifica OCL PRINTER. 


e Se non è indicata una specifica OCL PRINTER per la stessa unità di 
stampatatrice, il sistema continua il primo passo di stampa che è allocato 
dal programma che usa l'unità di stampatrice. 


Quando viene continuato un file di stampa, i parametri per quell’unità sono 
ignorati salvo NAME, DEVICE e CONTINUE. 


Se un passo di lavoro viene rilasciato (usando il parametro RELEASE sulla 
specifica OCL ATTR) o se esegue un programma per terminali richiedenti 
multipli (MRT), non può usare file di stampa continuati e definiti da altri 
passi del lavoro. Quel passo deve avere una propria specifica OCL PRINTER 
per quel file di stampa. 


NO specifica che il passo di stampa non deve più continuare. Il momento in 
cui il passo di stampa viene realmente chiuso dipende da quanto segue: 


e Se la specifica PRINTER non è tra la coppia di specifiche OCL LOAD 
e RUN il passo di stampa continuato viene considerato subito completo. 


e Se la specifica PRINTER è tra una coppia di specifiche OCL LOAD e 
RUN, il passo di stampa è considerato completo dopo che il passo di la- 
voro corrente termina {o dopo che il programma chiude il file di 
stampa). 


Quando il passo di stampa è completo, l’entrata di stampa differita è indicata 
come completa oppure la stampatrice viene rilasciata dal lavoro. 


PRIORITY specifica la priorità dell'emissione di stampa differita dal passo di la- 


voro. La priorità può essere rappresentata da qualsiasi numero decimale da 
5 a O. II sistema stampa le entrate di file di stampa differita con i numeri di 
priorità più elevata prima di quelle con priorità più bassa. Per esempio, tutta 
l'emissione stampata con una priorità di 5 viene stampata prima di qualsiasi 
entrata di file di stampa differita. Le entrate di file di stampa differita con 
le stesse priorità vengono stampate nell'ordine in cui sono state inserite nel 
file di stampa differita. Le entrate con priorità 1 sono le ultime stampate 
dal sistema. Se il parametro PRIORITY non viene specificato, si presume 
PRIORITY-1. 


Le entrate con priorità 0 sono disposte sul file di stampa differita con una 
priorità di 1 e sono congelate. Queste entrate non sono stampate fino a che 
non viene immesso un comando di controllo RELEASE per far sì che esse 
vengano esplicitamente stampate. 


L'ordine effettivo dell'emissione stampata può variare a causa del numero di 
modulo che viene usato. Vedere il parametro PRT sul Comando di controllo 
START per il modo in cui l'ordine può essere variato. 


ACTIVITY specifica l’attività prevista per il file di stampa differita. Ciò consente 
di controllare la dimensione della memoria di transito per l'intercettazione 
della stampa differita {che contiene provvisoriamente l'emissione della stam- 
patrice), allocata al programma per diminuire il tempo di elaborazione richie- 
sto dal programma. 


L'emissione differita è realmente scritta sul file di stampa differita quando ia 
memoria di transito per l’intercettazione della stampa differita allocata al 
programma si riempie; se la memoria di transito è troppo piccola per la 
quantità di attività, si riempie rapidamente e deve essere scritta molto spesso 
sul file di stampa differita, aumentando in tal modo i tempi di elaborazione 
per quel lavoro e per altri lavori sui sistema. Se la memoria di transito è 
troppo grande, può aumentare inutilmente la quantità della memoria centrale 
che il programma richiede. 


I parametro ACTIVITY è ignorato se non viene eseguito il differimento del- 
la stampa. 


NORMAL specifica che al programma deve essere allocata una memoria di 
transito per l’intercettazione della stampa differita di dimensione normale. 
{La memoria di transito è di 512 byte per l'emissione di lista del sistema; 
1280 byte per tutta l’altra emissione stampata). Se non viene specificato 
ACTIVITY, si presume ACTIVITY-NORMAL. 


HIGH specifica che al programma deve essere allocata una memoria di tran- 
sito per l'intercettazione della stampa differita molto più ampia del normale 
{la memoria di transito è di 2560 byte). 


MEDIUM specifica che deve essere allocata al programma una memoria di 
transito per l’intercettazione della stampa differita più ampia del normale 
(la memoria di transito è di 1280 byte). 


LOW specifica che al programma deve essere allocata una memoria di transi- 
to per l’intercettazione della stampa differita più piccola del normale (la me- 
moria di transito è di 256 byte). 


DEFER specifica se il sistema può iniziare l'emissione differita prima che sia 
completato il passo di stampa. Il parametro DEFER interessa soltanto l’emis- 
sione differita. 


YES specifica che il sistema non deve stampare l'emissione differita dal passo 
di stampa fino a che il passo di stampa non è completato. 


NO specifica che il sistema può iniziare l'emissione di stampa differita dal 
passo di stampa prima che il passo sia completato. 


Se si specifica DEFER-NO per un’emissione di stampa di lunga durata, è pos- 
sibile ridurre il tempo totale necessario per eseguire il programma e per stam- 
pare l'emissione. i 


HOLD specifica se l'emissione stampata deve essere conservata sul file di stampa 
differita dopo che è stata stampata. Per congelare l'emissione stampata sul 
file di stampa differita senza che venga stampata, vedere il parametro PRIO- 
RITY. 


NO specifica che l'emissione stampata non deve essere congelata e deve esse- 
re rimossa dai file di stampa differita dopo la stampa. Se non viene specifica- 
to HOLD, si presume HOLD-NO. 


YES specifica che l'emissione stampata deve essere congelata dopo che tutte 
le copie sono state stampate; il numero di copie congelate è impostato a 1. 
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JUSTIFY specifica la percentuale di emissione da una Stampatrice 5219 da giustificare 
a destra. Il sistema imposta il margine destro per la giustificazione basato sulla lun- 
ghezza del record. Per esempio, se la lunghezza del record è 80, tutto il testo è 
giustificato a colonna 80. Se l'emissione è stampata su una stampatrice diversa 
dalla 5219, il parametro JUSTIFY è ignorato. 


100 specifica che l'emissione deve essere giustificata a destra al 100%. 


50 specifica che l'emissione deve essere giustificata a destra al 50%. 


0 specifica che l'emissione non deve essere giustificata a destra. Se il parametro 
JUSTIFY non è specificato, O è assunto. 


FONT specifica il numero di identificazione della ruota di stampa da usare sulia stam- 
patrice 52190 la fonte da stampare sulla stampatrice 4224. Non tutte le fonti 
5219 sono disponibili sulla stampatrice 4224. La tabella che segue mostra i 
numeri validi di ID fonte e la loro coincidenza con le fonti della stampatrice 4224. 


ID Fonte 
5219 Descrizione Descrizione 









e [mese 
o |emeio [00 [eso 
e [resine ee [oo [conero 






ESS O CNN CC 
ta Je [oe femnero 

ommnisane [86 [esame 
e [see [80 fece 
o feat [ss [esere 
[66 [resine sie [66 [Coe 
De [urne [56 [come 
9F 
AO 
A2 
DF 












Boldface 


e] 
Cani 







Gothic 15 


Non tutte le fonti 4224 dovranno essere stampate con tutti i livelli di qualità. 
Se è specificato TEXT-YES, non possono essere utilizzate le fonti Gotiche. AI 
contrario, verranno usate le fonti Courier.‘ 

Se è specificato TEXT-NO o se il parametro TEXT non è specificato, e la quali- 
tà sul pannello dell'operatore della stampatrice è impostata a 001 (qualità DP), 
possono essere utilizzate soltanto fonti Gotiche. 





Con qualsiasi altra fonte indicata, verrà usata la corrispondente fonte Gotica. 
Gotico 12 verrà usato al posto della fonte Essay. Se invece la qualità sulla stam- 
patrice è impostata a 002 (qualità testo) o a 003 (qualità lettera), allora le fon- 
ti Gotiche non potranno essere usate. Le fonti Courier verranno usate soltanto 
se specificato TEXT-NO o con parametro TEXT mancante. 


Il valore assunto per difetto per il parametro FONT è specificato durante la pro- 
cedura CNFGISSP. Se l'emissione è stampata su una stampatrice diversa dalla 
5219 0 4224, il parametro FONT è ignorato. Se un valore specificato sia per 
il parametro CPI che per il parametro FONT, si avrà un messaggio di errore. 


TEXT specifica se l'emissione deve essere stampata in bozza o in stampa defi- 
nitiva. Se la stampa è per una stampatrice diversa da una 4214, 4224 o una 
5219 il parametro TEXT è ignorato. 


YES Specifica che l'emissione deve essere stampata con qualità definitiva, idi- 
pendentemente dal posizionamento dell’interruttore sulla Stampatrice 4214, 
4224 o 5219. 


NO specifica che la parola chiave TEXT non è usata sulla specifica OCL PRIN- 
TER. L'SSP invierà un comando alla starnpatrice che indicherà alla stessa di 
operare secondo l'impostazione del proprio interruttore di qualità se ne è 
provvista. 


Se gli interruttori sulle stampatrici non sono impostati in maniera adeguata, questo 
parametro è ignorato. Se il parametro TEXT non è specificato, è assunto il valore NO. 


EOFMSG specifica se il messaggio di fine moduli deve essere mandato all’operato- 
re di console o di sottoconsole. 


NO specifica che il messaggio di fine moduli non deve essere spedito. 


YES specifica che il messaggio di fine moduli deve essere spedito. Se il parametro 
EOFMSG non è specificato, è assunto il valore YES. 


Le combinazioni valide di questi parametri per le stampatrici disponibili sono indicate 
nella seguente tabella: 
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Parametro 


NAME 
DEVICE 
LINES 
LPI 

CPI 


FORMSNO 
ALIGN 
SPOOL 
COPIES 
CONTINUE 


PRIORITY 
ACTIVITY 
DEFER 
HOLD 
IGCCRPI 


SOSI 
TYPE 
EXTN 
JUSTIFY 
FONT 


TEXT 
EOFMSG 


5224 5225 

Mod. 1 Mod. 1 |Mod. 11 

Mod. 2 Mod. 4 |Mod. 12 
; X 


X X 


x Xx XX 
x XX XX 
x XX Xx 


baila Pa a GR a a Da Da 
MX XXX 
MIDO DX X 
MX MO dI XX 
Dea a GND a a Da Da 
XXX DO DIM XX 
ba Pa Dada Pai 
XXX XX 
x XX XX 


x XXX 
x XX Xx 
XX XX 
XXX X 


Esempio 1 


Per il programma denominato PROGRAMI, l'emissione sul file denominato 
PRINTI1 deve andare sulla stampatrice di sistema e deve essere differita. Vengono 
stampate tre copie e il SSP può iniziare la stampa prima che il passo di lavoro 
termini. 


// LOAD PROGRAMI 

// PRINTER NAME-PRINTI,COPIES-3,DEFER-NO 
// DEVICE-SYSTEM 

// RUN 


Esempio 2 
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L'emissione dei tre programmi deve essere stampata come un prospetto singolo sul- 
la stampatrice di sessione. 


// LOAD PROGI1 

// PRINTER NAME-PRINTIA,CONTINUE-YES 
// RUN 

// LOAD PROG2 

// PRINTER NAME-PRINT1B 

// RUN 

// LOAD PROG3 

// PRINTER NAME-PRINTIC 

// RUN 


XXX XX 


XXX Xx 


X 
x 
X 
x 
x 
x 
X 
X 
x 
x 
x 
x 
X 





SPECIFICA OCL PROMPT 


La specifica OCL PROMPT consente di. 


e Richiedere fino a 64 parametri di procedura usando uno o più tracciati video. 
E‘ possibile richiedere fino a 1024 caratteri. 


e Definire ciascun parametro per l'operatore, 
e Assegnare parametri assunti per difetto. 


e Mostrare il tracciato video da leggersi dalla prima operazione di lettura sul- 
l'unità video in un programma. Questo è anche chiamato tracciato sotto let- 


tura. 


La specifica OCL PROMPT fornisce un codice di ritorno (cioè alla procedura vie- 
ne ritornato un valore) per indicare quale tasto di comando o quale tasto di fun- 
zione è stato premuto. E’ possibile usare l’espressione di sostituzione ?CD? per 
determinare il valore di questo codice. Vedere Espressione ?2CD? (codice di ritor- 
no) per ulteriori informazioni. La tabella che segue mostra i tasti di comando e 
di funzione e i rispettivi codici di ritorno. Questi ultimi verranno impostati solo se 
non è specificato PDATA-YES. 


Cadice di ritorno Tasto premuto 

0000 ENTR/AVANZ. REC 

da 2001 a 2024 Tasti di comando da 1 a 24 

2090 Scorrimento in alto (È) 

2091 Scorrimento in basso (#) 

2092 RICH. AIUTO 

2093 Ritorno record (il tasto RIT. CURS. viene premuto 


mentre il cursore si trova nella prima posizione). 


Vedere il manuale Guida alla definizione dei tracciati video per la spiegazione del 
modo in cui disegnare e immettere tracciati video. La specifica OCL PROMPT 
non può essere usata per mostrare un tracciato video che contiene più di 1024 
caratteri di dati di emissione in fase di esecuzione. 


Alle specifiche D si applicano le seguenti regole per i campi di immissione e per 
i campi di emissione/immissione su un tracciato visualizzato dalla specifica 
PROMPT: 


e | campi devono essere definiti nell'ordine del numero di parametro sulla spe- 
cifica D. | campi non devono per contro comparire in ordine numerico di 
parametro sulio schermo. {La posizione sullo schermo è determinata dal nu- 
mero di righe e dalle entrate di posizioni orizzontali). 


e Normalmente l’entraia dei dati di emissione (colonne 23 e 24) deve essere 
un numero indicatore che corrisponde alla posizione del parametro nella pro- 
cedura. Se ad un parametro è già stato assegnato un valore quando viene vi- 
sualizzato il tracciato della richiesta, l'indicatore per il parametro viene atti- 
vato e viene visualizzato il valore assegnato. Se al parametro non è stato an- 
Cora assegnato un valore, viene visualizzato il valore costante assunto per di- 
fetto codificato nelle colonne da 57 a 64, Se nell'entrata dati di emissione 
viene specificato un numero indicatore maggiore di 11, comparirà sempre il 
valore assunto per difetto nelle colonne da 57 a 64 quando viene visualizzato 
il tracciato dalla specifica PROMPT. 
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// PROMPT 


e  Y deve essere specificato nell’entrata di immissione ammessa (colonna 26). 


e Può essere codificato un valore assunto per difetto nell'entrata Dati Costanti 
{colonne da 57 a 64). 


Posizione: La specifica OCL PROMPT può essere disposta ovunque tra le specifiche OCL. 
Non può essere immessa dalla tastiera ne è ammessa dalla coda di lavori o da un lavoro 
iniziato da una specifica OCL EVOKE. 


MEMBER-membro oggetto tracciati video,FORMAT-nome tracciato video 


ll 


| L1BRARY-nome Libreria] sl numero pri 


YES YES 


[iene "nn... | SPOADA (0 } suesI-{no } 





MEMBER specifica il nome del membro oggetto tracciati video che contiene il 
tracciato video. 


FORMAT specifica il nome del tracciato video che deve essere visualizzato. 


LIBRARY specifica la libreria in cui cercare il membro oggetto tracciati video. 
Se viene specificato un nome di libreria, la ricerca viene effettuata in quella 
libreria e quindi nelta libreria di sistema (LIBRARY). Se non viene immesso 
un nome di libreria, la ricerca viene effettuata nella libreria corrente e quindi 
nella libreria #LIBRARY. 


START specifica il numero del primo parametro di procedura da visualizzare e da 
richiedere. Qualsiasi precedente parametro le cui posizioni sono minori della 
posizione specificata, non è interessato. 


numero parametro può essere qualsiasi numero da 1 a 64. Se non viene spe- 
cificato alcun parametro, si presume il primo. 


2 


LENGHT specifica il numero delle posizioni di emissione e di immissione di trac- 
ciato video da usare per ciascun parametro di procedura che viene visualizza- 
to e richiesto. 


n. specifica la lunghezza di un parametro (gli apici non sono necessari) e il valore 
si applica al parametro specificato da START. 


‘n,n...° specifica la lunghezza di uno o più parametri iniziando con il parame- 
tro specificato da START. Ciascun n può avere un valore da 0 a 128. La lun- 
ghezza totale non può superare 1024 caratteri. 


tr 


Se non viene specificato un valore per una posizione (per esempio: ‘,,°), il pa- 
rametro deve avere una lunghezza di 8. 


Un valore di 0 indica che il parametro non deve essere visualizzato nè deve 
essere richiesto e che il campo di immissione per quel parametro deve essere 
salvato. Se viene specificato 0 come lunghezza del parametro, il valore e la 
lunghezza del parametro non sono modificati rispetto alia situazione esistente 
prima che venisse elaborata la specifica PROMPT. 


Quando viene presentato il tracciato video, i parametri sono visualizzati ini- 
ziando con la posizione più a sinistra nel campo del tracciato video. Se la 
lunghezza effettiva del parametro da visualizzare è maggiore del corrispon- 
dente valore di lunghezza specificato, i caratteri più a destra del parametro 
visualizzato vengono troncati (e cioè viene visualizzato soltanto il numero di 
caratteri più a sinistra). 


Dopo che l'operatore batte i parametri e preme il tasto ENTR o un tasto di 
comando valido, la lunghezza di ciascun parametro viene determinata contan- 
do il numero di caratteri immessi da sinistra a destra. Vengono contati tutti i 
caratteri, compresi gli spazi in bianco incorporati, fino al carattere diverso 
dallo spazio in bianco più a destra. Per esempio, se fosse immesso ‘ABC’, 
questo avrebbe una lunghezza di 4. Se venisse immesso ‘BBXYBZb' avrebbe 
una lunghezza di 6. li parametro in questo caso sarebbe BbXYBZ. 


PDATA specifica se l'immissione del tracciato video deve essere usata come pa- 
rametri o se deve essere congelata come immissione per la prima richiesta 
di immissione de! programma dall'unità video. 


NO specifica che l'immissione dallo schermo deve essere usata come parame- 
tri per una procedura e deve essere trattata come se fosse stata immessa con 
la procedura stessa. Se non viene specificato PDATA, si presume NO. 


YES specifica che l'immissione dal tracciato video deve essere usata come 
dati di programma e deve essere attribuita ad un programma alla sua prima 
richiesta di immissione dall'unità video. 


UPSI specifica se la regolazione corrente degli otto indicatori di stato UPSI deve 
essere inserita sulla tabella degli indicatori tracciato video. 


NO specifica che gli indicatori non devono essere usati. Se non viene specifi- 
cato UPSI, si presuma NO. 


YES specifica che la regolazione corrente degli otto indicatori di stato UPSI 


(da 1 a 8) deve essere inserita nella tabella degli indicatori tracciato video 
come indicatori, rispettivamente da 91 a 98. 
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Esempio 1 


La seguente specifica PROMPT visualizza un tracciato denominato DISPLAY1 
da un membro oggetto di tracciati video denominato PROMPTS. 


// PROMPT MEMBER-PROMPTS,FORMAT-DISPLAY1 


Esempio 2 


Vedere Esempio 3: Procedura SCRINPRT per un esempio di una procedura che 
usa la specifica OCL PROMPT. 


Esempio 3 


Le seguenti specifiche PROMPT mostrano due schermi di richiesta: il primo con- 
tiene le richieste per i parametri da :1 a 5; il secondo contiene le richieste per i 
parametri da 6 a 10. Il parametro 2 ha una lunghezza di 6, il parametro 9 ha una 
lunghezza di 20 e tutti gii altri parametri hanno una lunghezza di 8. La Figura 
34 e la Figura 35 mostrano i tracciati video usati con queste specifiche. 


// PROMPT MEMBER-SCREENS,FORMAT-DISPLAY1, Specifica Prompt per i 
// LENGTH-'8,6,8,8,8' parametri 1-50 
* 


// PROMPT MEMBER-SCREENS,FORMAT-DISPLAY2, Specifica Prompt per i 
// START-6,LENGTH-!,,,20,' parametri 6-10 
* 


PROCA 217,222,237,2U?,257,76?,27?,282,292,2107 


{| Esempio Formato Schermo 


I 1° Parte 


Parametro L. ....... 0... ch 
Parametro 2... 0.0... Lea (lunghezza = 6) 


I 
I 
I Parametro 3... dra 
I 


Parametro 4. ........... 3 


(| Parametro 5... proà 





Esempio formato schermo Display 1 
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Esempio Formato Schermo 


2° Parte 


Parametro 6 
Parametro 7............ 


Parametro 8 


(lunghezza = 20) 


Parametro 9 


Parametro 10 





Esempio formato schermo Display 2 


Esempio 4 


Le seguenti specifiche dimostrano un problema potenziale quando si assegnano para- 
metri di procedura prima che una specifica PROMPT sia elaborata. In questo esempio, 
la specifica PROMPT mostra una schermata di richiesta che contiene due campi: il Cam- 
po 1 è definito nella specifica D del tracciato video come un campo di immissione e 
il Campo 2 è definito come un campo di immissione/emissione. Il Campo 2 è definito 
anche sulla specifica D come un campo che deve avere dei dati forniti dal programma. 


// EVALUATE P1=A 
// PROMPT MEMBER-SCREENS,FORMAT-DISPLAY3, LENGHT-'1,2' 


* 


PROGB. ‘212,72? 


La figura 35.1 mostra come la schermata (DISPLAY3) appare dopo che la specifica 
PROMPT è elaborata: il carattere ‘‘A’’ è stato messo nel Campo 2 anche se la specifica 
EVALUATE PCE, elaborata prima della specifica PROMPT, aveva assegnato quel valore 
al primo parametro (P1). Per far corrispondere sia il campo che il parametro, l'operatore 
deve immettere ‘’A‘’’ nel campo 1. Se l'operatore avesse immesso anche i caratteri ‘‘BC” 
nel campo 2, i valori seguenti dovrebbero essere sostituiti in PROCB. 
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Î parametri assegnati prima della specifica PROMPT devono corrispondere nell'ordine 
con i campi di emissione o immissione/emissione che, definiti in un tracciato video de- 
vono avere dati forniti da un programma. 


I Esempio Formato Video 





Esempio formato video Display 3 
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spefina dire 





VESEOI 








ente bianca © 


Hi 









ina' lasciata' interiziona 


agi 
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SPECIFICA OCL REGION 


La specifica OCL REGION specifica la dimensione della regione per un lavoro o 
un passo di lavoro. La dimensione della regione di sessione assunta per difetto 
che era stata impostata dalla procedura SET o dal programma di utilità SETCF 
viene esclusa temporaneamente. 


Il sistema si assicura che sia disponibile una quantità di memoria centrale suffi- 
cientemente ampia almeno quanto la regione di lavoro per l'impiego da parte dei 
passi di lavoro nel lavoro. Se un passo di lavoro rilascia l'unità video richiedente 
oppure se il passo di lavoro esegue una procedura per terminali richiedenti mul- 
tipli, il passo di lavoro è in effetti un nuovo lavoro. il SSP non si assicura che ci 
sia sufficiente memoria disponibile per tali passi di lavoro. 


Il SSP considera come memoria disponibile tutta la memoria dell'utente non oc- 
cupata da programmi non scambiabili (i programmi non scambiabili forniti dalla 
IBM comprendono parti di MSRJE, parti di o tutte le funzioni di sottosistema 
SSP-ICF, il supporto BSC per RPGII e i programmi di comunicazione dati). Se 
tutti i programmi nella memoria sono scambiabili, la memoria disponibile è 
uguale alla memoria dell'utente. 


La dimensione della regione del passo di lavoro è la quantità massima di memoria 
che può essere usata dai programmi che richiedono memoria al di tà della dimen- 
sione dei rispettivi membri oggetto. La dimensione della regione del passo di la- 
voro è usata per limitare la dimensione di un passo di lavoro che usa una quanti- 
tà variabile di una memoria di centrale. Alcuni programmi di utilità di sistema po- 
tranno richiedere più spazio di quello specificato. 
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// REGION 


Posizione: La specifica OCL REGION può comparire ovunque tra ie specifiche 
OCL, salvo tra le specifiche OCL LOAD e RUN. 


Quando la specifica OCL REGION indica una dimensione di regione di lavoro, 
nel lavoro deve venire prima della specifica LOAD. 


Qualsiasi specifica OCL REGION che in un lavoro compare dopo la prima specifi- 
ca OCL REGION o dopo la prima specifica OCL LOAD si applica soltanto al 
successivo passo di lavoro. Se è indicata più di una specifica OCL REGION per 
un passo di lavoro, viene usata la dimensione di regione indicata sull'ultima speci- 
fica OCL REGION. 


SIZE-dimensione regione 


SIZE specifica la dimensione di regione in K-byte (1 K-byte equivale a 1024 
byte). La dimensione della regione può essere qualsiasi numero da 1 a 64 ma 
non può superare il numero di K:byte della memoria centrale a disposizione 
dell'utente. La regione è assegnata dal SSP arrotondata a un numero pari di 
K-byte. 


Esempio 


PROCA è una procedura di primo livello. | primi due programmi eseguiti come 
parte di PROCA, usano 24 K-byte di memoria centrale. Il terzo programma usa 
soltanto 14 K-byte di memoria centrale. PROCA contiene le seguenti specifiche: 


// REGION SIZE-2Ì 
// LOAD PROGI 

// RUN 

* 


// LOAD PROG2 
// RUN 
* 


// REGION SIZE-1h 
// LOAD PROG3 
// RUN 
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SPECIFICA OCL RESERVE 


La specifica OCL RESERVE indica la dimensione di un’area riservata su disco 
che è accantonata per contenere i file temporanei e di lavoro usati da un lavoro. 
Usando una specifica RESERVE, è possibile assicurarsi che sia disponibile suffi- 
ciente spazio su disco per i file di lavoro temporanei usati dal lavoro. 


Una volta che è riservata un’area, il SSP crea in essa tutti i nuovi file di lavoro e 
termporanei per il lavoro. Se non è disponibile spazio sufficiente nell’area riserva- 
ta per un nuovo file di lavoro o temporaneo, il SSP emette un messaggio di erro- 
re e l'operatore può scegliere di tentare di creare il file altrove sul disco oppure 
di cancellare il lavoro. 


AI termine di ciascun passo di lavoro, il SSP comprime automaticamente l’area 
riservata se durante il passo è stato cancellato qualche file di lavoro. AI termine 
dell'intero lavoro, il SSP libera automaticamente l'area riservata per l'uso da parte 
di altri programmi. 


Se esiste un'area riservata per il lavoro, il SSP ignora il parametro LOCATION 
delle specifiche OCL FILE per il nuovo file di lavoro e temporaneo. 


Un passo di lavoro che esegue un programma per terminali richiedenti multipli 
o un passo di lavoro che rilascia l’unità video richiedente, in effetti avvia un altro 
lavoro. Pertanto, i file di lavoro e temporanei creati da quei passi di lavoro non 
sono creati nell'area riservata per il lavoro. 


Posizione: in un lavoro, una specifica OCL RESERVE non può essere disposta 
tra le specifiche OCL LOAD e RUN. In un lavoro può essere usata soltanto una 
specifica RESERVE. 


// RESERVE BIOCKS-dimensione 





BLOCKS specifica la dimensione in numero di blocchi dell’area riservata. Se non 
è disponibile il numero di blocchi specificato nell’area dell'utente sul disco, il 
SSP emette un messaggio per l'operatore e attende che lo spazio venga dispo- 
nibile. Se lo spazio non diventa disponibile, è possibile usare il tasto ATTEN 
per interrompere e quindi cancellare il lavoro. 


Esempio 
Riservare 50 blocchi per il file temporaneo FILEA e per it file di lavoro FILEB. 


// RESERVE BLOCKS-50 

// LOAD PROGA 

// FILE NAME-FILEA,RETAIN-S,BLOCKS-20 
// FILE NAME-FILEB,RETAIN-J,BLOCKS-30 
// RUN 

// LOAD PROGB 

// FILE NAME-FILEB,RETAIN-J 

// RUN 
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SPECIFICA OCL RUN 


La specifica OCL RUN indica la fine delle specifiche OCL per un passo di lavoro. 
Dopo che il sistema ha letto ia specifica RUN, esegue il programma indicato nella 


specifica LOAD. 


Posizione: occorre una specifica OCL RUN per ciascun programma eseguito sul 
sistema. Essa è l’ultima nell'ambito di una serie di specifiche OCL. per ciascun 


passo di lavoro. 


// RUN 


La specifica OCL RUN non ha parametri. 


Esempio 


Per caricare ed eseguire un programma denominato PASTDUE. 


// LOAD PASTDUE 
// RUN 
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SPECIFICA OCL SESSION 


La specifica OCL SESSION assegna un programma applicativo ad una particolare 
sessione SSP-ICF su un particolare sottosistema. 


Qui sono indicati soltanto i formati della specifica. Vedere il manuale SSA-/CF 
Reference per una descrizione delle specifiche SESSION per i vari sottosistemi 
SSP-ICF. Vedere il manuale SSP-/CF Guide and Examples per gli esempi dei 
modo in cui è possibile usare la specifica OCL SESSION. 


Posizione: la specifica OCL SESSION deve essere inserita tra le specifiche OCL 
LOAD e RUN. 


Per il sottosistema Intra: 






// SESSION LOCATION-nome,SYMID-id sessione arci fo } 
| YES 
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Per il sottosistema BSCEL: 


// SESSION LOCATION-nome , SYMID-id sessione È SA } 
NORM 


AA NO 


,SWTYP- (MC [PHONE-nome menbro | Gase {ies j 
MA 


[peer (10 ì [-RRct-1ungnezza record! | 50k1-dunghezzo blocco | 
YES 


NO È 


|.REcsEP-carattere separatore | latta) , BLANK-{ C 
N 


ae { YES }| | asino 
NO 


Per il sottosistema BSC CCP: 


// SESSION LOCATION-nome,SYMID-id sessione |. sesnanpR- | 


NO” YES 


[.PHONE-none membro | ii) sn } .| ,LIBRARY-nome 
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Per il sottosistema BSC CICS: 





AA 


// SESSION LOCATION-nome ,SYMID-id sessione |. sesnaDDR-x] ,SWTYP- f MC 
MA 





È PHONE-nome menbro| ee }l fasi ata } ia 
NO YES 









Per il sottosistema BSC IMS: 









// SESSION LOCATION-nome,SYMID-id sessione Ni } 


YES 
[.10150-nn| [Pra | 


Per il sottosistema Finance: 





// SESSION LOCATION-nome,SYMID-iA sessione,LWSID-idA terminale logico 
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Per il sottosistema SNA Upline Facility: 


// SESSION LOCATION-nome SYMID-id sessione 


| .1usID-i0 terminale logico | [APPLID-i0 applicazione 


IMS YES 


, HOSTNAME- ( IMSRTR [REcL-1unghezza record] o } 
CICS 


sMSGPROT-f YES\ ||, BATCH-f NO 
NO YES 


Per il supporto BSC 3270: 





// SESSION LOCATION-nome ,SYMID-id sessione [. Data ID-ce ,FLDLER-1unghezza | 


[.pavabpR-xx ] , HOSTNAME- { OTHER 
7 CICS 
IMS 
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Per il sottosistema Peer: 


// SESSION LOCATION-nome,SYMID-id sessione 





Per il sottosistema APPC 


// SESSION SYMID-id.sessione,LOCATION-nome 


| -cR0UP-none gruppo sessioni | 





SPECIFICA OCL SWITCH 


La specifica OCL SWITCH imposta uno o più degli indicatori di stato del pro- 
gramma dell'utente (UPSI) per l’unità video su 1 (attivato) o 0 (disattivato). La 
regolazione degli indicatori rimane in atto fino a che non si verifica uno fra i se- 
guenti eventi: 


e Viene elaborata un’altra specifica SWITCH 
e Viene terminata la sessione all'unità video 
e Un programma modifica la regolazione di qualche indicatore 


Tutti gli indicatori sono disattivati quando inizia una sessione all'unità video e 
cioè quando un operatore si collega. 


Un lavoro inserito nella coda di favori usa una copia degli indicatori per l’unità video 
nella condizione in cui si trovavano quando il lavoro è stato inserito nella coda. Un 
lavoro richiamato o rilasciato con la specifica OCL ATTR, utilizzerà anche una copia 
degli indicatori della stazione video che erano impostati al momento del richiamo 
o del rilascio. Per determinare l'impostazione degli indicatori da una procedura, ve- 
dere ia Condizione SWITCH (Interruttori). 


Se una procedura SSP cambia l'impostazione di un indicatore, l'indicatore ritorna 
alla sua impostazione originale quando la procedura SSP termina. Esiste una serie 
di indicatori anche per ciascuna procedura per terminali richiedenti multipli 
(MRT). 
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Posizione: La specifica OCL SWITCH può comparire ovunque tra le specifiche 
OCL. 


// SWITCH impostazione indicatori 





impostazione indicatori indica come devono essere impostati gli indicatori e si 
compone di 8 caratteri, uno per ciascuno degli 8 indicatori. Il primo caratte- 
re ossia il più a sinistra, dà la regolazione dell'indicatore 1; il secondo carat- 
tere dà la regolazione dell'indicatore 2 e così via, 


Il parametro. deve sempre contenere 8 caratteri. Per ciascun indicatore, deve 
essere usato uno dei seguenti caratteri. 


Carattere Significato 


0 (zero) Disattiva l'indicatore 
1 (uno) Attiva l'indicatore 
X Lascia l'indicatore così com'è 


Esempio 
Questo esempio: 
// SWITCH 1XO110XX 


provoca i seguenti risultati: 





Indicatore Regolazione Risultato 
dell’interruttore 





Attivato 
Inalterato 
Disattivato 
Attivato 





Attivato 
Disattivato 
Inalterato 
Inalterato 


1 
2 
3 
4 
5 
6 
7 
8 
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SPECIFICA OCL SYSLIST 
La specifica OCL SYSLIST modifica la stampa o la visualizzazione dell'emissione 
di lista di sistema. L'emissione di lista di sistema è quella generata da tutti i pro- 
grammi di utilità SSP salvo i programmi di utilità per comunicazione dati e i sus- 
sidi di servizio. 
La specifica SYSLIST fa sì che l'emissione di lista di sisterna: 


e Sia listata sulla stampatrice che è stata assegnata all'unità video durante la 
configurazione del sistema 


e Sia listata su una delle altre stampatrici 
e Sia visualizzata sull’unità video 
e Non sia listata per nulla 


La specifica SYSLIST rimane in effetto fino a che la sessione dell'unità video 
non termina o fino a che non è modificata: 


e Da un'altra specifica OCL SYSLIST 
e Dalla procedura SYSLIST 


Una specifica OCL PRINTER in cui è indicato NAME-$SYSLIST, controlla ulte- 
riormente l'emissione di lista del sistema per un passo di lavoro. In questo caso, 
viene usata l'unità indicata sulla specifica PRINTER e non quella indicata sulla 
specifica SYSLIST. Vedere Specifica OCL PRINTER per ulteriori informazioni. 


Note: 

1. Se la procedura SYSLIST viene eseguita durante il modo interrogazione (cioè 
se l'operatore ha premuto il tasto ATTEN), la modifica effettuata dalla pro- 
‘cedura SYSLIST rimane in effetto soltanto durante il modo interrogazione. 

2. La specifica OCL SYSLIST non cambia l’unità di lista del sistema se è attiva- 


ta la ricerca e la correzione degli errori. Per ulteriori informazioni, fare riferi- 
mento alla Specifica OCL DEBUG. 


613 


Posizione: La specifica SYSLIST può ‘comparire ovunque tra le specifiche OCL. 


// SYSLIST | cRT 
PRINTER EXTN ,3 FOLD 


id stampatrice NOEXTN NOFOLD 
OFF 








CRT specifica che l'emissione di lista di sistema deve essere visualizzata sull'unità vi- 
deo richiedente. A seconda del modello del terminale video, sono visualizzate fino 
a 21 righe alla volta. Sono visualizzate almeno le prime 80 colonne dell'emissione. 


Dopo che è stato presentato ciascun schermo della lista di sistema, l'operatore può 
richiedere che venga visualizzata la successiva serie di righe o ché la visualizzazio- 
ne sia interrotta. Se l'operatore immette uno spazio in bianco, il numero di righe 
indicato sul successivo schermo sarà identico al numero di righe indicato sullo scher- 
mo precedente. Se l'operatore immette O, la visualizzazione viene terminata. Se 
l'operatore immette qualsiasi carattere diverso da uno spazio in bianco o compreso 
tra 0 e 18, (21 per il terminale video 3180 Modello 2), il prossimo gruppo di righe 


è visualizzato. 


L'emissione di sistema dai programmi per terminali richiedenti multipli è 
stampata sulla stampatrice di sistema. L'emissione di lista di sistema dei pro- 
grammi che rilasciano l’unità video richiedente e dai programmi che vengono 
eseguiti dalla coda di lavori è stampata sulla stampatrice di sessione. 


PRINTER specifica che l'emissione di lista di sistema deve essere stampata sulla 
stampatrice assegnata all'unità video durante la configurazione del sistema 
o assegnata dalla procedura SET o dal programma di uitilità $SETCF. 


id stampatrice specifica che l'emissione di lista del sistema deve essere stampata 
sulla stampatrice con l'ID di stampatrice specificato. E’ possibile usare.il 
comando STATUS WORKSTN per determinare gli ID di stampatrice. Per 
stampare l'emissione sulla stampatrice di sistema, specificare l'ID di stampa- 
trice della stampatrice di sistema. 


OFF specifica che non deve essere visualizzata o stampata alcuna lista di sistema. 


FOLD specifica che la lista di sistema visualizzata al terminale non deve essere troncata 
se eccede la larghezza del video. Invece i dati dopo la posizione 75 continueranno 
sulla riga successiva del video (per il 3180 Modello 2), i dati dopo ia posizione 130 
continueranno sulla prossima riga. 


NOFOLD specifica che la lista di sistema visualizzata al terminale è troncata se supera 
la larghezza del video. Se non è specificato nessun parametro, è assunto NOFOLD. 


Esempio 


Quello che segue è un esempio dell’assegnazione della stampatrice P2 per listare 
l'emissione di lista di sistema. 


// SYSLIST P2 
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// VARI I 


SPECIFICA OCL VARY 


ON 
OFF 


La specifica OCL VARY consente di cambiare lo stato di quanto segue da in 
linea e fuori iinea e viceversa: 


e Terminali video 

e La stampatrice di sistema 

e L'unità a minidischi 

e Le unità di controllo di comunicazioni 
e Le linee di comunicazioni 


e Le unità nastro 


Le unità che sono fuori linea non possono essere usate dagli operatori o dai pro- 
grammi. La specifica OCL VARY non può essere usata per portare fuori linea 
un'unità che è allocata ad un programma o che è collegata. La specifica OCL 
VARY deve essere immessa dalla console di sistema. Non è ammessa in una pro- 
cedura che viene richiamata o eseguita dalla coda dei lavori. 


Posizione: La specifica OCL VARY può comparirre ovunque tra le specifiche 
OCL salvo che tra le specifiche OCL LOAD e RUN. 


id terminale 

id stampatrice 

PRT 

(P) 

Il 

id unità di controllo 
,numero linea 

id unità di controllo, numero linea 
TI 

T2 

TC 


ON fa sì che l’unità specificata venga attivata. 
OFF fa sì che l'unità specificata venga disattivata. 


id terminale specifica l’id a due caratteri del terminale video da inserire in linea o 
da mettere fuori linea. E’ possibile usare il comando STATUS WORKSTN 
per determinare gli ID dei terminali video. 


Un terminale video deve essere scollegato per poter essere messo fuori linea. 
Se l’unità che viene messa fuori linea è una sottoconsole, qualsiasi messaggio 
che era stato inviato alla sottoconsole stessa, viene inviato alla console di si- 
stema. 


id stampatrice specifica l'ID a due caratteri di una stampatrice da inserire in linea 
o da mettere fuori linea. E’ possibile usare il comando STATUS WORKSTN 
per determinare gli ID delle stampatrici. 
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| programmi di scrittura in coda di stampa per una stampatrice devono essere 
interrotti o devono essere completati per poter mettere quella stampatrice 
fuori linea. E’ possibile usare il comando STATUS WRT per determinare se 
un programma di scrittura in coda di stampa è interrotto o completato. 


PRT o P specifica che la stampatrice di sistema deve essere posta in linea o messa 
fuori linea. 


11 specifica che l’unità a minidischi deve essere inserita in linea o messa fuori 
linea. 


id unità controllo specifica l'ID a tre caratteri di una unità di controllo di comu- 
nicazioni. Tutti i terminali video remoti e le stampatrici associate con l’unità 
di controllo specificata sono posti in linea o messi fuori linea. 


numero linea specifica il numero della linea di comunicazioni. Quando viene immesso 
questo parametro senza il parametro ID dell'unità di controllo, tutte le unità di con- 
trollo, i terminali video e le stampatrici associate a questa linea sono posti in linea 
o messi fuori linea. Quando viene immesso questo parametro con il parametro ID 
unità di controllo sulla specifica OCL VARY ON, l’unità specificata viene posta in 
linea sulla linea di comunicazioni specificata. 

id unità controllo, numero linea è valido soltanto per linee di comunicazioni 
commutate. Quando questi parametri vengono immessi sulla specifica OCL 
VARY ON, l’unità indicata viene messa in linea sulla linea di comunicazioni 
specificata. 


T1 specifica che l’unità nastro 1 deve essere inserita in linea o messa fuori linea. 
T2 specifica che l’unità nastro 2 deve essere inserita in linea o messa fuori linea. 


TC specifica che l’unità nastro a cassetta deve essere inserito in linea o messo fuori 
linea. 


Esempio 


Per inserire in linea tutti i terminali video remoti e ie stampatrici associate alla 
unità di controlio C01, immettere: 


// VARY ON,COLl 


PALI 


SPECIFICA OCL WAIT 


La specifica OCL WAIT fa sì che un lavoro debba attendere una certa ora del 
giorno o fino a che non è trascorso un certo periodo di tempo. Se viene elabora- 
ta la specifica OCL WAIT, il lavoro non riprende l'elaborazione fino a che non 
viene soddisfatta ia condizione specificata. Il lavoro può naturalmente essere ter- 
minato da una o dall'altra delle seguenti condizioni: 


e L'operatore che ha avviato il lavoro, può premere il tasto ATTEN e scegliere 
l'opzione di cancellare il lavoro. 


e L'operatore di sistema può usare il comando CANCEL per cancellare il 
lavoro. 


Usare cautela con questa specifica. Per esempio, se s'inserisce un lavoro contenen- 
te questa specifica nella coda dei lavori, è possibile far sì che il favoro impedisca 
l'elaborazione di altri lavori presenti nella coda. 


Quando viene elaborata la specifica OCL WAIT, qualsiasi risorsa del sistema (per 
esempio i file su disco, if moduio a minidischi o una stampatrice), allocata ad un 
lavoro in attesa, sono trattati come se fossero di proprietà di un programma sem- 
pre residente in memoria (NEP); vedere la Specifica OCL ATTR per ulteriori in- 
formazioni sui NEP. Ciò può evitare che altri programmi attendano le risorse di 
proprietà del lavoro in attesa. Quando viene raggiunta l'ora del giorno, tutte le ri- 
sorse vengono riportate alle rispettive condizioni precedenti. 
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Posizione: La specifica WAIT può comparire ovunque tra le specifiche OCL. 
La specifica WAIT può essere soltanto in una procedura; cioè non può essere im- . 
messa dalla tastiera. 


TIME-hhmmss 


INTERVAL-hhmmss 





TIME specifica che il lavoro deve interrompersi e attendere fino a che non arriva 
l'ora del giorno specificata. hhmmss specifica l'ora del giorno in cui il lavoro 
deve riprendere l'elaborazione. Deve essere immesso un numero a 6 cifre. 


Il tempo di ripresa effettivo dipende dal carico di lavoro del sistema e dal 
tempo di elaborazione. Per esempio, se la specifica OCL WAIT dice. // WAIT 
TIME-080000, ed il lavoro è presentato alle 075959, è possibile che anche se 
il lavoro deve cominciare alle 080000 possa attendere fino alle 080000 del 
giorno successivo a causa del tempo di elaborazione. Su un sistema occupato 
non è possibile garantire la precisione al secondo spaccato. 


hh specifica l'ora. Il valore deve essere da 00 a 24. | valori da 00 a 12 rap- 
presentano dalle 12.00 PM (mezzanotte) fino alle 12.00 AM (mezzogiorno). 
I valori da 13 a 24 rappresentano dalla 1.00 PM fino alle 12.00 PM (mezza 
notte). Sia 000000 che 240000 sono considerati mezzanotte. 


mm specifica i minuti. Il valore deve essere da 00 a 59. 
ss specifica i secondi. Il valore deve essere da 00 a 59. 


240000 è ii valore massimo che può essere specificato. Pertanto, se 24 sono 
le ore specificate, i valori dei minuti e dei secondi devono essere 00. 


INTERVAL specifica il tempo che un lavoro deve lasciar trascorrere prima di ri- 
prendere l'elaborazione. hhmmss specifica quanto il lavoro deve attendere 
prima di riprendere l'elaborazione. Deve essere immesso un numero a 6 cifre. 


hh specifica le ore. Il valore deve essere da 00 a 99. 
mm specifica i minuti. Il valore deve essere da 00 a 59. 
ss specifica i secondi. Il valore deve essere da 00 a 59, 


240000 è il valore massimo che può essere specificato. Pertanto se 24 è il 
numero delle ore specificate, i valori dei minuti e dei secondi devono essere 
00. 
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Esempio 1 


Il programma PROGA può essere eseguito soltanto dopo le 9.00 PM (ore 210000). 
La procedura per eseguire PROGA, potrebbe contenere le seguenti specifiche. 


// WAIT TIME-210000 
// LOAD PROGA 
// RUN 


Esempio 2 
La procedura deve attendere un minuto tra i passi di lavoro. 


// LOAD PROG1 

// RUN 

// WAIT INTERVAL-000100 
// LOAD PROG2 

// RUN 


Esempio 3 


Questo esempio mostra come far sì che una procedura attenda fino alle 4.00 PM. 
Se le 4.00 PM sono già passate, la specifica WAIT non viene elaborata. Per esem- 
pio, se la procedura venisse eseguita alle 5.00 PM, ia procedura PROCI1 verrebbe 
eseguita immediatamente: se non venisse eseguito ?TIME?, la procedura PROC1 
non verrebbe eseguita fino alle 4.00 PM del giorno successivo. 


/] IFF ?2TIME?>160000 WAIT TIME-160000 
PROC1 
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SPECIFICA OCL WORKSTN 


La specifica OCL WORKSTN fornisce al sistema informazioni relative ad una 
unità video usata da un programma. Una unità video può essere assegnata per 
l'impiego da parte di un programma in uno dei seguenti modi: 


e L'unità video richiamata viene automaticamente acquisita a meno che il pro- 


gramma non sia inserito nella coda dei lavori o richiamato. Non è richiesta 
alcuna specifica OCL WORKSTN per l’unità video richiedente. 


e Una specifica OCL WORKSTN che indica REQD-YES fa sì che il sistema ac- 
quisisca l’unità video specificata. 


e ll programma può eseguire l'operazione di acquisizione. Se il programma ac- 
quisisce un'unità video, la specifica WORKSTN è facoltativa. Quantunque 
il programma acquisisca l’unità video, si può usare la specifica WORKSTN 
in modo da poter specificare informazioni relative all'unità video. 


Posizione: La specifica WORKSTN può comparire ovunque tra le specifiche OCL. 
Tutti i parametri, salvo il parametro RESTORE-YES hanno effetto immediata- 
mente e rimangono in atto fino alla fine del passo di lavoro corrente. il parame- 
tro RESTORE-YES non ha effetto fino a che il terminale video viene usato nel- 

dai l'ambito di un passo di lavoro (si deve incontrare l'ID di terminale video che usa 
una specifica OCL PROMPT dopo la specifica WORKSTN e prima della specifica 
RUN oppure il programma deve eseguire operazioni di terminale video con l'ID 
di terminale video). 1! parametro RESTORE-YES rimane in effetto fino a che il 
terminale video non viene rilasciato o fino a che ii lavoro termina. Se compare 
la specifica WORKSTN dopo l’ultimo passo in un lavoro, avranno effetto i para- 
metri della specifica WORKSTN (compreso RESTORE-VYES). 


// WORKSTN UNIT-id terminale video [spia simbolico terminale] 


,REQD- f No ,RESTORE- si RETTO stanpatrice | 
YES NO NO 


,BORDER-f YES i; 
NO NO 





UNIT specifica l'ID a due caratteri di terminale dell'unità video usata dal pro- 
© gramma. E’ possibile usare il comando STATUS WORKSTN per determina- 
re gli ID delte unità video. 


SYMID specifica l'ID simbolico dei terminale usato dal programma. L'ID simboli 
co di terminale è un ID a due caratteri (il primo carattere non deve essere 
numerico) che il programma usa per fare riferimento all'unità video. L'ID sim- 
bolico non può essere identico all'ID di terminale assegnato a qualsiasi altra 
unità video o stampatrice sul istema. L'ID simbolico di terminale può essere lo 
stesso di quello del terminale specificato dal parametro UNIT. Se non è specifi- 
cato SYMID, l'ID simbotico di terminale viene assunto come identico all’ID 
di terminale specificato nel parametro UNIT. 
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REOD specifica se il SSP o se il programma applicativo deve acquisire l’unità vi- 


deo (se una unità video deve essere acquisita). Se l’unità video è l’unità video 
richiedente, non deve essere acquisita. 


NO specifica che il programma applicativo deve acquisire l’unità video. Se 
non è specificato il parametro REOQD, si presume REQD-NO. 


YES indica che il SSP deve acquisire l’unità video. 


RESTORE specifica: 


e Se lo schermo di comandi (o lo schermo dei menù, se viene usato un 
menù) deve essere ripristinato quando una unità video comandi viene 
rilasciata dal programma o quando il lavoro termina. 


e Se deve essere visualizzato lo schermo di attesa quando una unità video 
di immissione dati viene rilasciata da un programma oppure quando 
il lavoro termina. 


YES indica che l’ultima informazione visualizzata dal programma viene sosti- 
tuita dallo schermo dei comandi o dal menù su una unità video comandi o 
dallo schermo di attesa su una unità video per l'immissione dati, 


NO indica che l’ultima informazione visualizzata dal programma rimane sul- 
lo schermo. L'operatore deve premere il tasto ENTR per ripristinare lo scher- 
mo dei comandi, dei menù o di attesa. 


Se non è specificato RESTORE e l'ultima operazione dell'unità video era un’ 
immissione al programma, viene ripristinato lo schermo dei comandi, dei 
menù o di attesa. Se non è specificato RESTORE e l’ultima operazione ese- 
guita dall'unità video era un'emissione dal programma, non viene ripristinato 
lo schermo dei comandi, dei menù o di attesa. 


PRINT: specifica la stampatrice da usare quando l'operatore preme il tasto 
STAMPA. Se la stampatrice specificata viene già usata quando l’operatore 
preme il tasto STAMPA, viene visualizzato un messaggio di errore e l’opera- 
tore deve premere il tasto RIPR. TAST.; non viene stampata alcuna informa- 
zione. Se è attiva la stampa differita, l'emissione del tasto STAMPA viene a 
sua volta differita. 


id stampatrice specifica l'ID a due caratteri di stampatrice per la stampatrice 
che riceverà l'emissione del tasto STAMPA. 


NO specifica che il tasto STAMPA deve essere ignorato per l'unità video. 


Se non è specificato il parametro PRINT, il sistema usa la stampatrice assegnata 
all'unità video che ha lanciato il lavoro. 


Il parametro PRINT è in effetto soltanto: mentre l'unità video è allocata al 
programma. Se l'operatore preme il tasto STAMPA mentre l'unità video è nel 
modo comandi, il sistema usa la stampatrice assegnata all'unità video. 


BORDER specifica se deve essere stampato un margine intorno all'immagine del- 
lo schermo quando viene premuto il tasto STAMPA. 


YES specifica che deve essere stampato un margine. 
NO specifica che non deve essere stampato un margine. 

HEADER specifica se, quando viene premuto il tasto STAMPA, deve essere stam- 
pato un titolo nella parte superiore della pagina contenente l’immagine dello 
schermo. 


YES specifica che deve essere stampato un titolo. 


NO specifica che non deve essere stampato un titolo. 
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Esempio 


L'unità video W3 deve essere acquisita per l’impiego da parte del programma 
PROGA. ll programma usa il nome simbolico A1. Lo schermo dei menù, dei 

comandi o di attesa deve essere ripristinato quando l’unità video viene rilasciata. | SPE 
Se l'operatore preme il tasto STAMPA, le informazioni visualizzate devono essere 


stampate sulla stampatrice P2. 


// LOAD PROGA 
// WORKSTN UNIT-W3,SYMID-A1,REQD-NO,RESTORE-YES,PRINT-P2 


// RUN 


SPECIFICA /* (FINE DEI DATI) 


La specifica /* indica la fine dei dati immessi dalla tastiera o la fine dei dati ori- 


gine in linea. 


Posizione: una specifica /* deve essere l’ultima riga dei dati immessi dalla tastiera. 


/* 


La specifica /* non ha parametri e deve essere immessa nelle colonne 1 e 2. 


Esempio 


Questo esempio mostra una specifica di fine dei dati. 


Pisi 
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Capitolo 6. Comandi di controllo 


Questo capitolo descrive i comandi di controllo del Sistema/36 che sono forniti 
come parte del SSP. | comandi di controllo sono usati per controllare il sistema, 
le stampatrici e le unità video. Possono essere immessi dalla tastiera o selezionati 
da un'opzione di menù. Essi non possono essere codificati come parte di una 
procedura. | comandi di controllo sono divisi in tre gruppi: 


e Comandi di controllo che chiunque può immettere. 


e Comandi di controllo che è possibile immettere solo se si controlla una o 
più stampatrici. L'unità video che controlla una o più stampatrici è una sot- 
toconsole. 


e Comandi di controllo che l'operatore del sistema può immettere dalla conso- 
le di sistema. Se si usa una unità video di servizio di sistema, è possibile im- 
mettere tutti i comandi di controllo dell'operatore di sistema salvo: 


ASSIGN 

CANCEL SESSION per la console di sistem 
CONSOLE - 
POWER 

START SERVICE 

START SYSTEM 

STOP SERVICE 

STOP SYSTEM 

VARY 


Se l’unità video di servizio di sistema è anche una console di sistema alterna- 
tiva, può essere usato il comando CONSOLE. 


La descrizione di ciascun comando di controllo contiene: 
e Cosa il comando fa e chi può usarlo. 


e Il formato di sintassi del comando. Per una descrizione delle regole usate per 


descrivere i formati, vedere Convenzioni usate per descrivere la sintassi dei - 


formati. 
e Descrizione dei parametri del comando di controllo. 


e Unoo più esempi del modo in cui usare il comando di controllo. 
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Per informazioni sul funzionamento del Sistema/36, vedere il manuale Guida ope- 
rativa. 


Quando ci si collega al Sistema/36, è possibile usare il supporto di testi esplicativi 
per eseguire una funzione. Il supporto di testi esplicativi è costituito da menù, 
schermi di richiesta e testo esplicativo. !l menù consente di scegliere la funzione 
da eseguire. Quando si sceglie un'opzione da un menù: 


e Viene visualizzato un altro menù (quando si scelgono le varie opzioni, cia- 
scuna fornisce qualcosa di più specifico sulla funzione che si desidera ese- 
guire). 


e Viene presentato uno schermo di richiesta per una procedura o per un co- 
mando di controllo. 


Gli schermi di richiesta consentono di impostare comandi per eseguire la funzio- 
ne. Il testo esplicativo spiega i menù, le opzioni dei menù, le procedure e i co- 
mandi nonchè i parametri per le procedure e i comandi. 


Per ulteriori informazioni sul supporto esplicativo di sistema, vedere la Procedura 
HELP. 


Pai» 


COMANDO DI CONTROLLO ASSIGN 


L'operatore di sistema può usare il comando di controllo ASSIGN per provviso- 
riamente: 


e Scambiare gli ID di terminale di due unità video o di due stampatrici. Gli ID 
‘originali di terminale, sono ripristinati quando viene eseguito un IPL. 


e Assegnare una stampatrice come stampatrice di sistema. 


e Attivare o disattivare il supporto di sottoconsole per una unità video di sot- 
toconsole. 


Nota: le unità video o le stampatrici che vengono scambiate devono essere fuori 
linea. Se viene attivato o disattivato il supporto di sottoconsole, la sottoconsole 
che viene attivata o disattivata, deve a sua volta essere fuori linea. Vedere il co- 
mando di controllo VARY per informazioni sulla messa fuori linea di una unità. 


ASSIGN id terminale | ,idl terminale 


(A) 


PRT 
(P) 


SUB 
NOSUB 





id terminale specifica l'ID di terminale di una unità video o di una stampatrice. 
Dopo che il SSP ha elaborato il comando ASSIGN, la stampatrice o l'unità 
video avrà l'ID di terminale specificato da id1 terminale. 


PRT o P specifica che la stampatrice indicata da id1 terminale deve essere asse- 
gnata come stampatrice di sistema. 


SUB specifica che deve essere attivato il supporto di sottoconsole per l’unità vi- 
deo di sottoconsole specificata da id1 terminale. 


ASSIGN SUB occorre soltanto se è stato emesso un comando di controllo 
ASSIGN NOSUB per quell’unità video di sottoconsole. 


NOSUB indica che deve essere disattivato il supporto di sottoconsole per l’unità 


video di sottoconsole specificata da id1 terminale. Essa funzionerà ancora 
come unità video ma non sarà in grado di controllare le stampatrici. 
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id1 terminale specifica: 


® L'ID a 2 caratteri di una unità video o di una stampatrice che tempora- 
neamente scambierà il suo ID con l’unità video o la stampatrice identifi- 
cata da id terminale. 


e Se viene immesso SUB o NOSUB, l'ID dell'unità video che avrà il sup- 
porto di sottoconsole attivato o disattivato. 


e Se viene immesso PRT, l'ID di una stampatrice che deve essere assegnata 
come stampatrice di sistema. 


Esempio 1 


L'unità video W1 non è in funzione; per scambiare gli ID dell'unità video con 
l’unità video identificata come W3, l'operatore di sistema deve immettere: 


VARY OFF,W1 
VARY OFF,W3 
ASSIGN W3,W1 
VARY ON,W1 


oppure 


V OFF,WIl 
V OFF,W3 
A W1,W3 
V ON,Wl 
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Esempio 2 


Per assegnare la stampatrice P2 come stampatrice di sistema (che è correntemente 
P1), l'operatore di sistema immette: 


VARY OFF,P1 
VARY OFF,P2 
ASSIGN PRT,P2 
VARY ON,P2 
VARY ON,PI 


Esempio 3 


Per disattivare il supporto di sottoconsole dall'unità video di sottoconsole W3, 
l'operatore di sistema immette: 


VARY OFF,W3 
ASSIGN NOSUB,W3 
VARY ON,W3 


Esempio 4 


Per attivare il supporto di sottoconsole per l’unità video di sottoconsole W3, 
l'operatore di sistema immette: 


VARY OFF,W3 
ASSIGN SUB,W3 
VARY ON,W3 
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COMANDO DI CONTROLLO CANCEL 
E’ possibile usare il comando di controllo CANCEL per: 
e Cancellare le entrate sul file di stampa differita 
e Cancellare i lavori nella coda dei lavori 


Se si controlla una o più stampatrici: è possibile anche usare il comando di con- 
trolio CANCEL per: 


e Cancellare una o tutte le entrate sul file di stampa differita per una stampa- 
trice specifica controllata. 


e Cancellare tutte le entrate sul file di stampa differita per tutte le stampatrici 
controllate. 


L'operatore di sistema o l'operatore dell'unità video di servizio di sistema può 
usare il comando di controllo CANCEL, per: 


e Cancellare una o tutte le entrate sul file di stampa differita. 
e Cancellare unoo tutti i lavori nella coda dei lavori. 
e Cancellare un lavoro correntemente in esecuzione. 


e Cancellare la sessione di una unità video (e cioè scollegare un’altra unità vi- 
deo dal sistema). 


CANCEL PRT,|ia entrata stampa differita Si 
(c) (P) $ ia stampatrice 
ALL 


JOBQ,fnome lavoro 
(J) ALL 


SESSION,id terminale video 
(8) 


nome lavoro,|2 
3 
DUMP 
(D) 
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PRT o P specifica che devono essere cancellati uno o più lavori dal file di stampa 
differita. 


id entrata stampa differita specifica ID a 6 caratteri dell'entrata del file di 
stampa differita da cancellare. Può essere usato il comando STATUS PRT 
per determinare gli ID del file di stampa differita. 


id stampatrice specifica l'ID a 2 caratteri di una stampatrice per la quale de- 
vono essere cancellate tutte le entrate del file di stampa differita. Occorre 
avere il controllo della stampatrice. 


ALL specifica che devono essere cancellate tutte le entrate del file di stampa 
differita di tutte le stampatrici controllate. (L'operatore di sistema o l’opera- 
tore dell'unità video di servizio di sistema può controllare tutte le stampa- 
trici). 


JOBOQ o J specifica che uno o più lavori devono essere cancellati dalla coda dei 
lavori. 


nome lavoro specifica il nome a 8 caratteri di un lavoro, nella coda dei lavo- 
ri, da cancellare. Il comando STATUS JOBO può essere usato per visualizza- 
re i nomi dei lavori nella coda dei lavori. 


ALL specifica che tutti i lavori neila coda favori devono essere cancellati. 
ALL può essere immesso solo dalla console di sistema o dall'unità video di 
servizio di sistema. 


SESSION o S specifica che deve essere cancellata ia sessione per una unità video. 
L'unità video specificata viene scollegata dal sistema. Questo parametro può 
essere immesso soltanto dalla console di sistema o da una unità video di ser- 
vizio di sistema. L'unità video di servizio di sistema non può scollegare la 
console di sistema. 


id terminale video specifica l'ID a 2 caratteri dell'unità video da scollegare. 
E' possibile usare il comando di controllo STATUS WORKSTN per determi- 
nare gli ID. 


nome lavoro specifica un lavoro correntemente in esecuzione da cancellare. Il se- 
condo parametro specifica come il lavoro deve essere terminato. Può essere 
usato il comando STATUS USER per visualizzare i nomi dei lavori corrente- 
mente in esecuzione. Questo parametro può essere immesso soltanto dalla 
console di sistema. 


2 specifica che deve essere effettuata una cancellazione controllata. Qualsiasi 
file, vecchio o nuovo, che viene usato dal lavoro, viene chiuso. Qualsiasi pas- 
so di lavoro rimanente non viene elaborato. 


3 specifica che deve essere effettuata una cancellazione immediata. Qualsiasi 
vecchio file che viene usato dal lavoro, viene chiuso. Tutti i passi di lavoro 
rimanenti non sono elaborati. Vedere la nota che segue. 


DUMP o D specifica che deve essere eseguita una cancellazione immediata 
con una stampa di funzione. Tutti i file che vengono usati dal lavoro non 
sono chiusi. La memoria centrale assegnata al lavoro viene scritta sul disco, 
su un'area di copia della memoria del sistema. | passi di lavoro rimanenti non 
sono elaborati. Vedere nota che segue. 
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Nota: Se viene specificato 3 o DUMP (D) quando un lavoro viene cancellato, 
può verificarsi quanto segue: 


e Qualsiasi nuovo file creato dal programma che era in esecuzione va perso. 


e Se il programma in esecuzione ha aggiunto record ad un file non condi- 
viso, i record aggiunti vanno persi. 
Esempio 1 
Per cancellare il lavoro del file di stampa differita SP0010, immettere: 
CANCEL PRT,SPOO10 


oppure: 


C P,SPOO10 


Esempio 2 


Per cancellare il lavoro W3123412 dalla coda di lavori, immettere: 


CANCEL JOBQ,W3123412 


«Esempio 3 


Per cancellare tutti i lavori dalla coda dei lavori, l'operatore di sistema deve im- 
mettere: 


CANCEL JOBQ,ALL _ 


Esempio 4 


Per cancellare immediatamente il lavoro W2001820 che è correntemente in esecu- 
zione, l'operatore di sistema deve immettere: 


C W2001820 
oppure 


C W2001820,3 


Esempio 5 


Per scollegare l’unità video W2 dal sistema, l'operatore di console dei sistema 
deve immettere: 


CANCEL SESSION,W2 


oppure 


C_S,W2 
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COMANDO DI CONTROLLO CHANGE 


E’ possibile usare il comando CHANGE per: 


Cambiare il numero di copie da stampare per le entrate del file di stampa 
differita. 


Cambiare lo stato di differimento per le entrate del file di stampa differita. 


Cambiare il numero del modulo da usare per le entrate del file di stampa dif- 
ferita. 


Cambiare la stampatrice usata per le entrate del file di stampa differita. 


Se si controlla una o più stampatrici è anche possibile usare il comando CHAN- 
GE per: 


Cambiare la stampatrice usata per l’entrata del file di stampa differita con 
una stampatrice controllata. È 


Cambiare fa posizione di un'entrata del file di stampa differita per una stam- 
patrice controllata. 


Cambiare la priorità del programma di scrittura di stampa differita che stam- 
pa le entrate per una stampatrice controllata. 


Cambiare il numero di pagine di separazione da inserire tra l'emissione stam- 
pata per una stampatrice controllata. 


L'operatore di sistema o l’operatore dell'unità video di servizio di sistema, può 
usare il comando CHANGE anche per cambiare la posizione di un lavoro nella coda 
dei lavori o per specificare il numero dei lavori che il sistema può avere attivi. 
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COPIES,numero copie,id entrata stampa differita 


sa entrata stampa differita 
NO 


FORMS,numero modulo,id entrata stampa differita 
ID,nuovo id li ia stampatrice } 


id entrata stampa differita 


PRT,id entrata stampa differita, [ia entrata stampa aifrerita | 
(P) 


PRTY,|HIGH ,|id stampatrice 
NORMAL | |stampatrice di sistema 





SEP,|0O |,|id stampatrice 
stampatrice di sistema 


l 
2 
3 


JOBQ,nome lavoro, [nomel levoro | 
(I) 


COPIES specifica che deve essere modificato il numero di copie dell'emissione 
stampata per un lavoro. 


numero copie specifica il numero di copie da stampare per il lavoro, e può 
essere qualsiasi numero da 1 a 255. 


id entrata stampa differita specifica l'ID a 6 caratteri di un'entrata del file di 
stampa differita. Può essere usato il comando STATUS PRT per determinare 
gli ID del file di stampa differita. 





TA 


DEFER specifica che deve essere modificato lo stato di differimento per una par- 
ticolare entrata di file di stampa differita. 


dla YES indica che l’entrata di file di stampa differita non deve iniziare la stam- 
pa fino a che il programma non ha completato l’entrata di file di stampa dif- 
ferita. 


NO indica che l'entrata del file di stampa differita può iniziare la stampa prima 
che il programma abbia completato l'entrata di stampa differita. Se non viene 
specificato alcun parametro, si presume NO. 


id entrata stampa differita specifica l'ID a 6 caratteri di un'entrata di file di 
stampa differita. L'entrata di file di stampa differita non deve essere ancora 
completata dal programma che la crea. Può essere usato il comando STATUS 
PRT per determinare gli ID del file di stampa differita. 


FORMS specifica che deve essere modificato il numero di modulo da usare per 
un'entrata di file di stampa differita. E’ possibile usare ii comando di con- 
trolio STATUS WRT, per determinare quali moduli sono correttamente usati 
dalla stampatrice. Il comando di controllo STATUS PRT identifica quali modu- 
li devono essere usati per ciascuna entrata dei file di stampa differita. 


numero modulo specifica il numero di modulo da usare per l'ID di stampa 
differita specificato; possono essere immessi da 1 a 4 caratteri. 


id entrata stampa differita specifica l'ID a 6 caratteri dell'entrata’ del file di 
stampa differita. L'entrata del file di stampa differita non deve essere in cor- 
so di stampa. Il comando STATUS PRT può essere usato per determinare 
IID del file di stampa differita. 


ID specifica che la stampatrice da usare per una o più entrate di file di stampa 
differita deve essere cambiata. 


Nota: Se si invia l'emissione di stampa su una stampatrice con caratteristiche 
diverse, si potrebbero ottenere errori di stampa o di programma con risultati 
imprevedibili. 


nuovo id stampatrice specifica l'ID a 2 caratteri della nuova stampatrice da 
usare. 


vecchio id stampatrice specifica l'ID a 2 caratteri della stampatrice corrente. 
Tutte le entrate del file di stampa’differita da stampare che usano questa 
stampatrice useranno la nuova. Se è correntemente in stampa sulla vecchia 
stampatrice un'entrata di file di stampa differita, fa stampa continuerà sulla 
stessa stampatrice. Occorre però avere il controllo su questa stampatrice. 


id entrata stampa differita specifica l'ID a 6 caratteri di un'entrata del file di 
stampa differita. Il comando STATUS PRT può essere usato per determinare 
gli ID del file di stampa differita. Se viene specificato un ID di stampa diffe- 
rita nella terza posizione del parametro, quell’entrata di file dì stampa diffe- 
rita userà la nuova stampatrice. L'entrata del file di stampa differita non 
deve essere in corso di stampa. 

PRT o P specifica che la posizione dell'entrata sul file di stampa differita deve es- 
sere cambiata. 


id entrata stampa differita specifica l'ID a 6 caratteri dell'entrata del file di 
stampa differita da spostare. Il comando STATUS PRT può essere usato per 
determinare gli ID del file di stampa differita. 


id1 entrata stampa differita specifica l'ID a 6 caratteri di un'entrata del file 
di stampa differita. id stampa differita è spostato alla posizione che segue /d7 
entrata stampa differita e gli viene attribuita la stessa priorità di id1 entrata 
— stampa differita. Se non è specificato id1 entrata stampa differita, l'entrata 


stampa differita che viene modificata, viene spostata davanti al file di stampa 


differita e gli viene attribuita una priorità di 5, Per informazioni sulle priorità 
delle entrate dei file di stampa differita, vedere il manuale Concepts and Pro- 
grammer's Guide. 
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PRTY specifica che deve essere modificata la priorità di elaborazione per il pro- 
gramma di scrittura di stampa differita per la stampatrice specificata. Per in- 
formazioni sulla priorità di elaborazione dei lavori, vedere il manuale Con- 
cepts and Programmer's Guide. 


HIGH indica che il programma di scrittura di stampa differita deve avere 
un’elevata priorità di elaborazione. Ciò può far sì che l'emissione venga stam- 
pata più velocemente. Notare che mentre il programma di scrittura di stampa 
differita viene eseguito più velocemente, altri lavori sul sistema possono venire 
eseguiti più lentamente. 


NORMAL indica che il programma di scrittura di stampa differita deve avere 
una normale priorità di elaborazione. Se non viene specificato alcun parame- 
tro, si presume NORMAL. 


id stampatrice specifica l'ID a 2 caratteri della stampatrice la cui priorità di 
programma di scrittura di stampa differita deve essere modificata. Occorre 
però avere il controllo di questa stampatrice. Se non viene specificato alcun 
parametro, si presume la stampatrice di sistema. 


SEP specifica che il numero di pagine di separazione da stampare tra le entrate 
del file di stampa differita deve essere cambiato. E’ possibile specificare 0, 
1, 2 o 3 pagine di separazione. Se non viene specificato alcun parametro, 
si presume 0. Le pagine di separazione vengono usate per distinguere l'emis- 
sione per i diversi file di stampa. 


id stampatrice specifica l'ID a 2 caratteri della stampatrice di cui si deve mo- 
dificare il numero delle pagine di separazione. Occorre però avere il controllo 
su questa stampatrice. Se non viene specificato alcun parametro, si presume 
la stampatrice di sistema. 


JOBO o J specifica che la posizione di un lavoro nella coda di lavori deve essere 
cambiata. 


Nota: Questo parametro può essere immesso soltanto dalla console di sistema 
o dall'unità video di servizio di sistema. 


nome lavoro specifica il nome a 8 caratteri del lavoro da modificare. E’ pos- 
sibile usare il comando di controllo STATUS JOBO per determinare il nome 
dei lavori. 


nome1 lavoro specifica il nome a 8 caratteri di un lavoro nella coda dei lavo- 
ri. Il nome lavoro è spostato alla posizione che segue nome?/avoro. Se nome1- 
lavoro non è specificato, nome /avoro viene spostato davanti alla coda dei 
lavori e gli viene data una priorità di coda di lavori di 5. Vedere il Comando 
di controllo JOBOQ per ulteriori informazioni sulla priorità della coda dei la- 
vori. 


JOBS specifica che si vuole modificare il numero di lavori da eseguire immediata- 
mente dalla coda lavori o la priorità della coda lavori. 


JOBO specifica che si vuole modificare il numero di lavori che devono essere ese- 
guiti immediatamente dalla coda lavori. 


priorità coda lavori specifica che si vuole modificare il numero dei lavori che devono 
essere eseguiti immediatamente dalla priorità coda lavori assegnata. 


JOBS specifica il numero di lavori che devono-essere eseguiti dalla coda lavori o 
dalla priorità coda lavori specificata. 


Nota: ] valori immessi da questo comando rimangono in effetto fino al succes- 
sivo comando CHANGE JOBS o fino alla eventuale ricostruzione del file coda 
lavori. 


Esempio 1 


Per spostare il lavoro W3083001 nella coda dei lavori in modo che segua il lavoro 
W1051050, l'operatore deve immettere: 


CHANGE JOBQ,W3083001,W1051050 
oppure 


G J,W308001,W1051050 


Esempio 2 


Per modificare l’entrata del file di stampa differita SP0011 in modo che vengano 
stampate 5 copie della sua emissione, l'operatore deve immettere: 


CHANGE COPIES,5,SPOO11 
oppure: 


G COPIES,5,SP0011 


Esempio 3 


Per far sì che non vengano stampate pagine di separazione tra i lavori suHa stam- 
patrice P3, l'operatore che controlla P3, deve immettere: 


CHANGE SEP,0,P3 
oppure 


G SEP,,P3 


Esempio 4 


Per far sì che il programma di scrittura di stampa differita per la stampatrice P2 
venga eseguito con alta priorità, l'operatore che controlla P2 deve immettere: 


G PRTY,HIGH,P2 
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COMANDO DI CONTROLLO CONSOLE 


È possibile usare il comando di controllo CONSOLE per trasferire la funzione di con- 
sole di sistema da quella configurata ad una console di sistema alternativa. Si pos- 
sono specificare unità video locali e remote come console di sistema alternative quan- 
do si configura il sistema. Vedere il manuale Modifica della configurazione del siste- 
ma per ulteriori informazioni. Ogni unità video collegata con il supporto DHCF è au- 
tomaticamente una console di sistema alternativa. 


Se è attiva la riservatezza mediante parola d'ordine, deve essere immesso il co- 
mando CONSOLE da un operatore cui è stata assegnata la classificazione di riser- 
vatezza di operatore di sistema o più elevata. 


ll comando CONSOLE GIVE deve essere immesso alla console di sistema e non 
può essere immesso da un'unità video designata come unità di servizio di sistema. 


Il comando CONSOLE TAKE deve essere immesso da un video comandi; cioè 
non deve essere immesso da uno schermo di interrogazione o da uno schermo 
di console. 


GIVE 


CONSOLE Ji lia unità video 
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TAKE specifica che la funzione di console di sistema deve essere svolta da una 
console di sistema alternativa. TAKE è specificato dall'operatore della conso- 
le di sistema alternativa che diventa la console di sistema. Se non viene speci- 
ficato alcun parametro, si presume TAKE. 


CONSOLE TAKE può essere immesso per una qualsiasi delle seguenti condi- 
zioni: 


e La console di sistema corrente non sta lavorando. 


e La console di sistema corrente è disattivata. 


° La console di sistema corrente è su una ubicazione remota non più in 
collegamento. 


e E’ stato immesso un comando CONSOLE GIVE. 


e Viene visualizzato il messaggio IPL in esecuzione su una console di sistema 
alternativa (può essere immesso soltanto la parola CONSOLE). 


Anche l'operatore della attuale console di sistema può immettere CONSOLE 
TAKE. Se non viene immesso alcun ID di unità video, l’effetto del comando 
CONSOLE GIVE è ignorato. Cioè nessun operatore può utilizzare la console 
di sistema. Se viene immesso un ID di unità video, l'operatore all'unità video 
specificata non può prendere la console di sistema. Cioè il comando CONSOLE 
GIVE per quell’unità video viene ignorato. 


id unità video specifica l'ID a 2 caratteri di un'unità video che non deve ot- 
tenere il permesso di prendere la console di sistema. 


L'immissione: 
CONSOLE ,id unità video 


non è ammessa, 


TR 


2° 


GIVE specifica che la funzione di console di sistema deve essere messa a disposi. 
zione di una console di sistema alternativa. Deve essere IMMESssO un comando 
CONSOLE TAKE perchè il trasferimento venga completato. 


id unità video specifica l'ID a 2 caratteri della console di sistema alternativa 
che diventa la console di sistema. Se non viene immesso l'ID dell'unità video, 
qualsiasi console di sistema alternativa può diventare la console di sistema. E’ 
possibile usare il comando di controllo STATUS WORKSTN per determinare 
quali unità video sono console alternative. 


La console di sistema corrente rimane tale fino a che non viene immesso il 
comando CONSOLE TAKE. La console corrente di sistema deve essere nel 
modo comando perchè il comando CONSOLE TAKE funzioni. 


Esempio 1 


Si verifica un errore sulla console di sistema che ne impedisce l'uso. Per assegnare 
l’unità W3 {una console di sistema alternativa), come console di sistema, l’opera- 
tore di sistema si collega dall'unità video W3 e immette: 


CONSOLE 


Esempio 2 


Per passare la console di sistema da W1 a W3, l'operatore della console di sistema 
immette quanto segue su W1 (la console di sistema corrente): 


CONSOLE GIVE,W3 


L'operatore della console di sistema quindi si collega da W3 e immette quanto 
segue per fare di W3 la console corrente di sistema: 


CONSOLE TAKE 


Esempio 3 


Questo esempio mostra un comando di controllo CONSOLE GIVE che consente 
all'unità video W3 di sostituire la console di sistema. Qualche tempo dopo, ma 
prima che l'operatore di W3 abbia immesso il comando di controllo CONSOLE 
TAKE, l'operatore di sistema immette un comando di controllo CONSOLE TA- 
KE che fa sì che il sistema ignori il precedente comando CONSOLE GIVE. 


CONSOLE GIVE,W3 


CONSOLE TAKE,W3 


Nota: Se la console di sistema corrente è una unità video collegata ad una ubicazio- 
ne DHCF (Distributed Host Command Facility) e le comunicazioni con questa ubi- 
cazione sono interrotte, sarà necessario eseguire i passi che seguono prima di uti- 
lizzare il comando CONSOLE per trasferire la funzione di console di sistema: 


® Utilizzare il comando STATUS SUBSYS (DI) per determinare il nome del sotto- 
sistema SSP-ICF da usarsi per comunicare. con l'ubicazione DHCF. 


e Utilizzare la procedura DISABLE per disattivare il sottosistema SSP-ICF. 


e Dopo circa 30 secondi, si potrà usare il comando CONSOLE per trasferire la 
funzione di console di sistema. 
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COMANDO DI CONTROLLO HOLD 
E’ possibile usare il comando di controllo HOLD per: 
e Impedire che le entrate del file di stampa differita vengano stampate. 


e Impedirechei lavori nella coda dei lavori vengano elaborati. 


Se si controllano una o più stampatrici è anche possibile usare il comando di 
controllo HOLD per impedire che vengano stampate una qualsiasi o tutte le en- 
trate del file di stampa differita per una stampatrice controllata. 


L'operatore di sistema o l'operatore dell'unità video di servizio di sistema può 
anche usare il comando di controllo HOLD per: 


e Impedire che vengano stampate una qualsiasi o tutte le entrate del file di 
stampa differita. 


e Impedire che venga elaborato qualsiasi lavoro nella coda dei lavori. 


Se un comando HOLD PRT specifica un'entrata di file di stampa differita che è 
in corso di stampa, la stampa di quell'entrata viene interrotta e inizia la stampa 
della successiva entrata del file di stampa differita. L'entrata congelata può essere 
stampata quando un comando di controllo RELEASE rilascia quell’entrata di file 


di stampa differita. 


id entrata stampa differita 
(P) ‘ id stampatrice 
ALL 


JOBQ,nome lavoro 


(3) 





PRT o P specifica che devono essere congelate una o più entrate sul file di stam- 
pa differita. 


id entrata stampa differita specifica l'ID a 6 caratteri dell'entrata del file di 
stampa differita da congelare. Può essere usato il comando STATUS PRT per 
determinare gli ID del file di stampa differita. 


id stampatrice specifica l'ID a 2 caratteri di una stampatrice. Devono essere 
congelate tutte le entrate del file di stampa differita della stampatrice speci- 
ficata. Sono congelate soltanto le entrate che sono: attualmente nel file di 
stampa differita; le entrate inserite nel file di stampa differita dopo il coman- 
do HOLD PRT non verranno congelate. 


ALL specifica che devono essere congelate tutte le entrate del file di stampa 
differita per tutte le stampatrici controllate. Vengono congelate soltanto le 
entrate che sono attualmente nel file di stampa differita; tutte le entrate in- 
serite nel file di stampa differita dopo che viene elaborato il comando HOLD 
non verranno congelate. 
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JOBOQ o J specifica che deve essere congelato un lavoro nella coda dei lavori. 
nome lavoro specifica il nome a 8 caratteri di un lavoro, nella coda di lavori, 


da congelare. ll comando STATUS JOBO può essere usato per visualizzare 
i nomi dei lavori nella coda dei lavori. 


Esempio 1 


Per congelare il lavoro W3121536 nella coda di lavori, l'operatore di sistema deve 
immettere: 


HOLD JOBQ,W3121536 


oppure 


H J,W3121536 


Esempio 2 


Per congelare l’entrata SP0012 del file di stampa differita, l'operatore deve im- 
mettere: 


HOLD PRT,SPOO12 
oppure 


H P,SP0012 


Esempio 3 


Per congelare il file di stampa differita per la stampatrice P3, l'operatore che con- 
trolla P3, deve immettere: 


H P,P3 
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INFOMSG 
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COMANDO DI CONTROLLO INFOMSG 


E’ possibile usare il comando di controllo INFOMSG per: specificare se si deside- 
ra visualizzare i messaggi informativi. } messaggi informativi sono visualizzati dalla 
specifica //*. 


L'operatore di sistema: non deve rispondere ai messaggi informativi emessi dal 
SSP (se si è immesso INFOMSG NO nel modo console sulla console di sistema). 


| messaggi visualizzati con la specifica //** sono sempre visualizzati sulla console 
di sistema. 


YES 
NO 


YES specifica che deve essere visualizzato qualsiasi messaggio informativo. Qual- 
siasi messaggio informativo visualizzato sulla console di sistema mentre opera 
nel modo console deve avere una risposta usando il comando REPLY. Se 
non è specificato un parametro, si presume YES. 


NO specifica che qualsiasi messaggio informativo emesso dalla specifica //* non 
viene visualizzato. Inoltre, quando immesso sulla console di sistema o sulla 
sottoconsole mentre opera nel modo console, qualsiasi messaggio informativo 
visualizzato non deve avere una risposta. 


Esempio 


Per impedire che eventuali messaggi informativi inviati all'unità video vengano vi- 
sualizzati, l'operatore deve immettere: 


INFOMSG NO 


COMANDO DI CONTROLLO JOBO 


E’ possibile usare il comando di controllo JOBO per: inserire un lavoro nella 
coda dei lavori. 


II comando di controllo JOBO deve essere immesso dal video comandi. Il numero 
totale di caratteri generati dalla tastiera per il comando JOBO non può superare 


i 120. 


priorità in coda lavori,| nome libreria ,nome procedura, 


3 libreria corrente 


| perami ,sparam2,.. | 


priorità in coda lavori specifica la priorità della coda dei lavori, cioè l'ordine di elabo- 
razione dei lavori dalla coda. La priorità in coda lavori può essere qualsiasi nu- 
mero da 0 a 5. Nella scelta del successivo lavoro da eseguire il sistema esegue 
i lavori con numero di priorità più elevata prima di quelli con numero di priorità 
più basso. Per esempio, tutti i lavori con una priorità in coda lavori di 5 vengo- 
no eseguiti prima di qualsiasi altro lavoro nella coda. | lavori con la stessa prio- 
rità in coda lavori sono eseguiti nell'ordine in cui sono stati immessi nella coda. 
{ lavori con un priorità in coda lavori di 1, sono gli ultimi lavori eseguiti dal si- 
stema. La priorità in coda lavori 0 è solitamente interrotta e cioè qualsiasi lavo- 
ro inserito nella coda lavori con la priorità 0 non viene eseguito fino a che l’o- 
peratore del sistema non avvià la priorità O. 


Se non viene specificato alcun parametro, al lavoro viene assegnata una prio- 
rità in coda lavori di 3 e ia virgola indicata in questo parametro non deve 
essere specificata. 


nome libreria specifica la libreria per il lavoro. Il sistema cerca nella libreria speci- 
ficata e quindi nella libreria di sistema le procedure, i membri oggetto, i 
membri di messaggi e i tracciati video usati in questo lavoro. Se non è speci- 
ficato alcun parametro, si presume la libreria corrente. 


nome procedura specifica la procedura che definisce il lavoro da inserire nella 
coda dei lavori. 


param1, param2,.. specifica qualsiasi parametro richiesto dalla procedura. E’ pos- 
sibile specificare da 1 a 64 parametri. Vedere la Specifica OCL INCLUDE 
per ulteriori informazioni sul modo in cui i parametri possono essere speci- 
ficati. 
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Esempio 1 


Per inserire la procedura PAYROLL, che è disposta nella libreria PAYLIB, nella 
coda dei lavori con una priorità di 3, l'operatore deve immettere: 


JOBQ PAYLIB,PAYROLL,FILEA,FILEB 


Esempio 2 


Per inserire la procedura PAYROLL che è posta nella libreria PAYLIB nella coda 
dei lavori con una priorità di coda lavori di 5, l'operatore deve immettere: 


JOBQ 5,PAYLIB,PAYROLL,FILEA,FILEB 


COMANDO DI CONTROLLO MENU 


E” possibile usare i! comando di controllo MENU per: visualizzare un menù del- 
l'utente. (Per visualizzare un menù esplicativo vedere la Procedura HELP). 1 menù 
consentono di scegliere le procedure o i comandi di controllo mediante un nume- 
ro anzichè dover immettere per intero la procedura o il comando di controllo. 


Per esempi di menù dell'utente e per informazioni sulla creazione di menù dell'u- 
tente, vedere il manuale Guida alla definizione dei tracciati video. 


E’ possibile rimuovere un menù dell'utente dallo schermo comandi immettendo 
uno 0 come opzione di menù. 


Il comando MENU deve essere immesso da un video comandi. 


nome menù, [nome libreria] 





nome menù specifica il menù dell'utente da visualizzare. 
nome libreria specifica la libreria contenente il menù. Se non è specificato un 
nome di libreria, il sistema cerca il menù neila libreria corrente, se ne esiste 


una e quindi cerca nella libreria di sistema (#LIBRARY). La libreria speci- 
ficata diventa la libreria di sessione. 


Esempio 1 


Per visualizzare il menù M12 che è nella libreria corrente, l'operatore deve immet- 
tere: 


MENU M12 


Esempio 2 


Per visualizzare il menù PAYROLL che è nella libreria MYLIB, l'operatore deve 
immettere: 


MENU PAYROL,MYLIB 
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COMANDO DI CONTROLLO MODE 


E’ possibile usare il comando di controllo MODE per disporre l'unità video nel 
modo di funzionamento detto modo attesa, in cui attende di essere acquisita e 
usata da un programma. Se viene immesso il comando MODE quando l’unità vi- 
deo è nel modo attesa, l’unità video ritorna al suo normale modo di funziona- 


mento. 


Mentre l’unità video è nel modo attesa, possono essere immessi soltanto i coman- 
di MODE, MSG e OFF. 


Il comando MODE deve essere immesso da un video in modo attesa o comandi. 


MODE 


Il comando MODE non ha parametri. 


Esempio 


Una unità video è nel normale modo di funzionamento. Per cambiare il modo di 
funzionamento dell'unità video che questa possa essere acquisita da un program- 
ma, l'operatore immette: 


MODE 
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COMANDO DI CONTROLLO MSG 
E° possibile usare il comando di controllo MSG per: 


e Visualizzare messaggi inviati all'unità video. 


e Visualizzare un messaggio di console di sistema che era stato inviato anche al- 
l'unità video (a titolo informativo). Tale messaggio è detto messaggio a doppio 
istradamento. 


e Inviare un messaggio alla console di sistema, a un’altra unità video o ad un 
altro operatore. 


e Inviare un messaggio a tutte le unità video. 


} messaggi ricevuti da una unità video sono disposti nella coda di messaggi per 
quell’unità video. Se l'operatore è collegato all'unità video, interviene un segnale 
acustico e la spia dei messaggi si accende. E’ possibile avere fino a 25 messaggi 
nella coda di messaggi dell'unità video. Se vengono ricevuti messaggi quando la 
coda è piena, i messaggi non sono inseriti nella coda e il mittente è avvertito che 
la coda dei messaggi è piena. 


Se viene inviato un messaggio ad un operatore che non è collegato ed esiste il 
file di identificazione dell'utente, quel messaggio viene inserito nella coda di mes- 
saggi per quell’operatore. ll messaggio verra visualizzato quando l'operatore si col- 
lega. Se il file di identificazione dell'utente non esiste, oppure quell’operatore 
non ha un'entrata nel file di identificazione dell'utente, viene visualizzato un mes- 
saggio di errore all'operatore che tenta di trasmettere il messaggio. 


I messaggi inviati ad un'unità video sono. visualizzati quando: 
e Unoperatoresi collega all'unità video. 


e Un operatore immette il comando OFF (salvo quando è specificato OFF 
DROP su una linea di comunicazioni commutata). 


e L'operatore immette il comando MSG senza parametri. 

e Un lavoro eseguito dall'unità video termina. 

e L'operatore passa dal modo comando al modo console o sottoconsole. 
Quando un messaggio viene visualizzato, viene rimosso dalla coda dei messaggi. 


Quando viene eseguito un caricamento dei programma iniziale (IPL), tutti i mes- 
maggi vengono rimossi da tutte le code dei messaggi. 


id unità video|,testo messaggio 


id utente 
ALL 





Se non vengono specificati i parametri, i messaggi accodati all'unità video sono 
visualizzati. Se non viene immesso il primo parametro ma viene immesso il se- 
condo, il messaggio viene inviato alla console di sistema in modo console. 
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id unità video specifica l'ID a 2 caratteri dell'unità video alla quale il messaggio 
deve essere inviato. Può essere usato il comando STATUS WORKSTN per de- 
terminare l'ID dell'unità video. 


Se vengono immessi l'ID dell'unità video della console di sistema e un mes- 
saggio, il messaggio viene inviato al video comandi della console di sistema. 
(Può essere osservato dallo schermo di console). 

id utente specifica l'ID da 1 a 8 caratteri dell'utente che identifica l'operatore al 
quale deve essere inviato il messaggio. Può essere usato il comando STATUS 
WORKSTN per determinare gli ID degli utenti. 

Se è specificato l'ID dell'utente dell'operatore di sistema, il messaggio viene 
inviato al video comandi della console di sistema (può essere osservato dal 
video della console). 


ALL specifica che il messaggio deve essere inviato a tutte le unità video attive, 
salvo l’unità video stessa. 


testo messaggio specifica il messaggio da trasmettere. E’ possibile immettere fino 
a 75 caratteri speciali o alfanumerici. 


Esempio 1 
Un operatore dell'unità video sta preparandosi a immettere un lavoro che richiede 


il minidisco BFILE. Per informare l'operatore di sistema che è richiesto il minidi- 
sco BFILE, l'operatore dell'unità video immette: 


MSG ,INSERIRE PER FAVORE IL MINIDISCO BFILE IN Sl 


Esempio 2 


Per informare l'operatore sull'unità video W4 che non possono essere immessi 
altri lavori, l'operatore di sistema immette: 


MSG Wi,NON IMMETTERE ULTERIORI LAVORI 


Esempio 3 


Per inviare un messaggio a tutti gli operatori sul sistema: 


MSG ALL,INTERROMPETE I LAVORI, NECESSITA IL SISTEMA DEDICATO 
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COMANDO DI CONTROLLO OFF 


E” possibile usare il comando di controllo OFF per: scollegare una unità video 
dal sistema. ll comando OFF non è elaborato a meno che non siano terminati 
tutti i lavori che usano l’unità video. 


1 messaggi nel file messaggi per l’unità video sono visualizzati all'atto dello scoliega- 
mento a meno che non si specifichi OFF DROP su una unità video a distanza su una 
linea di comunicazione commutata. Se i messaggi non sono visualizzati, rimangono in 
coda e possono essere visualizzati successivamente. 


H comando OFF deve essere immesso da un video comandi. 


DROP e HOLD sono usati soltanto per le unità video a distanza su linee di comuni- 
cazione commutate e unità video collegate attraverso un video-passante. Questi 
parametri vengono ignorati per le altre unità video. 


DROP specifica che la sessione comunicazioni per l’unità video non è più necessa- 
ria. Se l’unità video è in collegamento tramite un video-passante, ia procedura 
PASSTHRU termina e l’unità video comunicherà soltanto col proprio sistema 
locale. 


: Se l’unità video è in collegamento tramite RWS (work station support), ia linea 
: di comunicazioni verrà chiusa se tutte le unità video di quella linea sono inatti- 
ve. Sullo schermo di collegamento apparirà un messaggio indicante che lo scol- 
legamento è avvenuto con successo. Se lo schermo è di console di sistema, 
una console alternativa potrà usare il comando CONSOLE per trasferire la fun- 
zione di console di sistema non appena la linea di comunicazione viene chiusa. 


HOLD specifica che la sessione di comunicazione deve essere mantenuta. Appare 


lo schermo di collegamento. Se il video è in collegamento tramite una unità 
video-passante, lo schermo di collegamento sarà per il sistema remoto. 


Esempio 
Per scollegare l'unità video dal sistema, immettere: 


OFF 
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COMANDO DI CONTROLLO POWER 


L'operatore di sistema: può usare il comando di controllo POWER su qualsiasi 
terminale video per spegnere il sistema, 


Se sono in esecuzione lavori, viene visualizzato un messaggio sulla console di si- 
stema e l'operatore può far sì che il comando POWER venga ignorato (i lavori 


possono continuare l'esecuzione), riprovare (per vedere se i lavori sono ancora 
in esecuzione) o procedere con lo spegnimento del sistema. 


POWER OFF 


OFF specifica che il sistema deve essere spento. 
Esempio 


Per spegnere il sistema, l'operatore del sistema deve immettere: 


POWER OFF 
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COMANDO DI CONTROLLO PRTY 


E’ possibile usare il comando di controllo PRTY per: modificare la priorità di 
elaborazione del successivo lavoro eseguito dall'unità video o del successivo lavoro 
inserito nella coda dei lavori. 


L'operatore di sistema o l'operatore di unità di servizio di sistema: può anche 
usare il comando PRTY per modificare la priorità di elaborazione di un lavoro 
attualmente in esecuzione o di un lavoro nella coda lavori. 


i lavori con priorità NORMAL possono avere la piorità di elaborazione modifi- 
cata automaticamente dal sistema. | favori con priorità HIGH, MEDIUM e LOW, 
non possono cambiare automaticamente priorità. Vedere il manuale Learning 
about your Computer per ulteriori informazioni sulla priorità dei lavori. 


[nome Lavoro | »| HIGH 
ON 


MEDIUM 


OFF 
NORMAL 
LOW 





nome lavoro specifica il nome di 8 caratteri la cui priorità di elaborazione deve 
essere modificata. Può essere usato il comando STATUS USER o il comando 
STATUS JOBO per determinare il nome del lavoro. 


Nota: Questo parametro può essere immesso soltanto sulla console di sistema 
oppure su una unità video di servizio di sistema. 


HIGH o ON specifica che le risorse del sistema sono assegnate al lavoro prima 
che vengano assegnate ad un lavoro con priorità inferiore (MEDIUM, NOR— 
MAL, OFF o LOW). Se non è specificato un secondo parametro, si presume 
HIGH. 


MEDIUM specifica che le risorse del sistema sono assegnate al lavoro prima che 
vengano assegnate ad un lavoro a priorità inferiore (NORMAL, OFF o LOW). 


OFF o NORMAL specifica che le risorse del sistema sono assegnate al lavoro 
prima che vengano assegnate ad un lavoro con priorità LOW. 


LOW specifica che le risorse del sistema sono assegnate al lavoro dopo che tutti 


gli altri lavori a priorità più elevata hanno avuto la loro assegnazione di risor- 
se di sistema. 
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Esempio 1 


Per assegnare alta priorità. al lavoro W2010112 l'operatore di sistema deve im- 
* sistema). na 


PRTY W2010112 


Esempio 2 
Per assegnare un'alta priorità alla procedura PROCA, l'operatore deve immettere: 


PRTY 
PROCA 


() 


RELEASE 
(L) 


COMANDO DI CONTROLLO RELEASE 


E” possibile usare il comando di controllo RELEASE per. 


Rilasciare per la stampa le entrate del file di stampa differita. 


Rilasciare i lavori dalta coda di lavori per l'elaborazione. 


Se si controlla una o più stampatrici: è possibile usare il comando di controllo 
RELEASE per: 


Rilasciare una o tutte le entrate del file di stampa differita per una specifica 
stampatrice controllata. 


Rilasciare tutte le entrate congelate del file di stampa differita per tutte le 
stampatrici controllate. 


L'operatore di sistema o l'operatore dell'unità video di servizio di sistema: può 
anche usare il comando di controllo RELEASE per: 


PRT, 
(P) 


Rilasciare una o tutte le entrate congelate del file di stampa differita. 


Rilasciare tutti i lavori dalla coda dei lavori. 


id entrata stampa differita 
id stampatrice 
ALL 


JOBQ,nome lavoro 


(3) 


PRT o P specifica che devono essere rilasciate una o più entrate del file di stam- 


pa differita. 


id entrate stampa differita specifica l'ID a 6 caratteri dell'entrata del file di 
stampa differita da rilasciare. Può essere usato il comando STATUS PRT per 
determinare gli ID del file di stampa differita. 


id stampatrice specifica l'ID a 2 caratteri di una stampatrice. Devono essere 
rilasciate tutte le entrate del file di stampa differita da stamparsi sulla stam- 
patrice specificata. Sono rilasciate soltanto le entrate attualmente congelate 
su! file di stampa differita; qualsiasi entrata congelata inserita nel file di 
stampa differita dopo l'elaborazione del comando RELEASE, non viene 


rilasciata. 


ALL specifica che devono essere rilasciate tutte le entrate del file di stampa 
differita per tutte le stampatrici controllate. Vengono rilasciate soltanto le 
entrate attualmente congelate sul file di stampa differita; qualsiasi entrata 
congelata che viene inserita nel file di stampa differita dopo l'elaborazione 
del comando RELEASE non viene rilasciata. 
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JOBOQ o J specifica che deve essere rilasciato un lavoro dalla coda dei lavori. 
nome lavoro specifica il nome a 8 caratteri di un lavoro nella coda dei lavori, 


da rilasciare. Può essere usato il comando STATUS JOBO per visualizzare il 
nome dei lavori nella coda dei lavori. 


Esempio 1 


Per rilasciare il lavoro W3121536 dalla coda dei lavori, l'operatore deve immet- 
tere: 


RELEASE JOBQ,W3121536 


oppure 


L J,W3121536 


Esempio 2 


Per rilasciare il lavoro SP0013 del file di stampa differita, l'operatore deve immet- 
tere: 


RELEASE PRT,SP0013 


Esempio 3 


Per rilasciare tutte le entrate del file di stampa differita, l'operatore di sistema 
deve immettere: 


L P,ALL 


‘Esempio 4 


Per rilasciare le entrate del file di stampa differita per la stampatrice P3, l’opera- 
tore che controlla P3, deve immettere: 


LP B3 


COMANDO DI CONTROLLO REPLY 


E” possibile usare il comando di controllo REPLY per: 


Rispondere ad un singolo messaggio sullo schermo Console. 
Rispondere a tutti i messaggi informativi sullo schermo Console. 


Comprimere lo schermo Console in modo che vengano visualizzati soltanto 
i messaggi che devono ancora ricevere una risposta. 


Rispondere ad un singolo messaggio su una sottoconsole che viene visualiz- 
zato con il comando di controllo STATUS MESSAGE. 


Per rispondere ad un messaggio o per visualizzare informazioni esplicative relative 
ad un messaggio: 


messaggio, [risposte | 





Per rispondere a tutti i messaggi informativi o per cancellare lo schermo: 


o. 
6. 
. 
(1) 
REPLY I 
(R) Ù 


id messaggio specifica I"!D di messaggio a 2 caratteri che identifica il messaggio a 


cui si deve rispondere. 


risposta specifica fa risposta al messaggio. Per esempio, se si deve rispondere ad 


un messaggio SSP, ia risposta potrebbe essere 0, 1, 2, 3 o D. 


1 specifica che occorre rispondere a tutti i messaggi informativi. Quando viene 


specificato |, è richiesto REPLY o R. 


C cancella lo schermo da tutti i messaggi cui è stata data risposta. Occorre 


REPLY o R quando viene specificato C. 
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Esempio 1 


Sullo schermo di console o di sottoconsole compare il seguente messaggio: 


02 SYS-1405 Opzioni (012) 
Si desidera separatore pagine stampa differita per 
stampatrice Pl... 


Per selezione l'opzione 0, l'operatore immette: 
REPLY 02,0 
oppure: 
R 2,0 
oppure: 
2,0 
Per ottenere ulteriore testo per il messaggio, l'operatore miele 
R 2 
oppure 


2 


Esempio 2 


Per cancellare lo schermo di sottoconsole o lo schermo della console di sistema 
da tutti i messaggi informativi e dai messaggi cui è stata data risposta, l'operatore 
immette: 


RI 
RC 


il comando R | risponde a tutti i messaggi informativi e il comando R C cancella 
lo schermo, lasciando soltanto quei messaggi cui non è stata ancora data risposta 
(eventualmente). 


COMANDO DI CONTROLLO RESTART 


Se si controllano una o più stampatrici: è possibile usare il comando di controllo 
RESTART per riavviare la stampa di un'entrata del file di stampa differita per la 
stampatrice controllata. E' possibile riavviare la stampa dall'inizio dell'entrata spe- 
cificata oppure dall’inizio di una pagina specifica di quell’entrata. 


RESTART PRT,lid entrata stampa differita], | PAGE 


(T) (P) [id stampatrice numero pagina 
stampatrice di sistema 


PRT o P specifica che deve essere riavviata la stampa dell'entrata del file di stam- 
pa differita. 


id entrata stampa differita specifica l'ID a 6 caratteri dell'entrata del file di stam- 
pa differita da riavviare. Può essere usato il comando STATUS PRT per de- 
terminare gli ID dei file di stampa differita. 


id stampatrice specifica i'1D a 2 caratteri della stampatrice da riavviare. Se non 
viene specificato alcun ID di stampatrice, si presume la stampatrice di siste- 
ma. E' possibile usare il comando STATUS WRT per visualizzare gli ID delle 
stampatrici. 


PAGE specifica che la stampa deve essere riavviata all’inizio della ultima pagina 
che era stata parzialmente stampata dal programma di scrittura del file di 
stampa differita. Se l'emissione non era stata parzialmente stampata, la stam- 
pa comincia all'inizio della prima pagina. 


numero pagina specifica il numero di pagina dalla quale deve ripartire la stampa. 
Se non è specificato il numero di pagina, la stampa riparte all’inizio della 
emissione stampata. ll numero massimo di pagina è 65.535. 
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Esempio 1 
Per riavviare la stampa dell'entrata corrente de! file di stampa differita all’inizio 
della pagina 6 sulla stampatrice di sistema, l'operatore che controlla quest’ultima 
immette: 
RESTART PRT,,6 


oppure 


T P,,6 


Esempio 2 


Per riavviare la stampa dell'entrata SP0012 del file di stampa differita all'inizio 
dell'ultima pagina stampata: 


RESTART PRT,SPOO012,PAGE 
oppure 


T P,SP0012,PAGE 


PR 


FE 


COMANDO DI CONTROLLO START 


Se si controlla una 0 più stampatrici: è possibile usare il comando di controllo 
START per: 


e Avviare la stampa di tutte le entrate del file di stampa differita per una spe- 
cifica stampatrice o per tutte le stampatrici controllate. 


e Avviare la stampa di tutte le entrate del file di stampa differita con un nu- 
mero specificato di modulo per una specifica stampatrice o per tutte le stam- 
patrici controllate. 


e Avviare la stampa di tutte le entrate del file di stampa differita per una spe- 
cifica stampatrice o per tutte le stampatrici controllate in modo che le en- 
trate che usano gli stessi moduli vengono stampate insieme. 


L'operatore di sistema o l'operatore dell'unità di servizio di sistema: può usare il 
comando di controllo START per: 


e Avviare la stampa di tutte le entrate del file di stampa differita per una spe- 
cifica stampatrice o per tutte le stampatrici. 


e Avviare la stampa di tutte le entrate del file di stampa differita con il nume- 
ro di modulo specificato per una specifica stampatrice o per tutte le stampa- 
trici. 


e Avviare la stampa delle entrate del file di stampa differita per una specifica 
stampatrice o per tutte le stampatrici in modo che vengano stampate insie- 
me le entrate che usano gli stessi moduli. 


e Riprendere l'esecuzione di un lavoro o di tutti i lavori che erano stati inter- 
rotti da un comando STOP JOB. 


e Avviare l'esecuzione di lavori dalla coda dei lavori. 


e Consentire l’uso di una unità video come unità video di servizio di sistema. 
(Ciò può essere fatto soltanto dalla console di sistema). 


e Riprendere l'attività SSP-ICF che era stata interrotta da un comando STOP 
SESSION. 


e Riprendere l’attività di sistema che era stata interrotta da un comando STOP 
SYSTEM (ciò può essere fatto soltanto dalla console di sistema). 


e Consentire l'avviamento dei lavori da tutte le unità video o da una unità vi- 
deo specificata che era stata fermata da un comando STOP WORKSTN. 
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PRT,|id stampatrice s|numero modulo 
(P) |stampatrice di sistema FORMS 
ALL 





JOB,fnome lavoro 
ALL 


JOBQ, | ALL 
(J) |priorità in coda lavori 
nome lavoro 


SERVICE,id unità video 


SESSION 
(N) 


SYSTEM 
(S) 


ALL 


o unità ut 


(w) 





PRT o P specifica che deve essere avviato un programma di scrittura di stampa 
differita per una stampatrice; cioè le entrate del file di stampa differita pos- 
sono essere stampate solo quando la stampatrice è disponibile. Il parametro 
PRT può essere usato per avviare la stampa di lavori del file di stampa dif- 
ferita dopo l’IPL se durante la configurazione del sistema non è stata sele- 
zionata la funzione di avviamento automatico (detta anche autowriter). Il 
parametro PRT può anche essere usato per avviare il programma o i program- 
mi di stampa differita dopo l'immissione del comando STOP PRT; la stampa 
inizia con il primo lavoro del file di stampa differita. 


Se non viene immesso il secondo parametro, si presume la stampatrice di si- 
stema. Se non viene immesso il terzo parametro, il programma di scrittura 
di stampa differita stampa le entrate disponibili secondo la rispettiva posi- 
zione nel file di stampa differita. 


id stampatrice specifica l'ID a 2 caratteri della stampatrice per la quale deve 
essere avviato il programma di scrittura di stampa differita. Se non è specifi- 
cato: alcun parametro, viene presunta la stampatrice di sistema. E’ possibile 
usare il comando di controllo STATUS WRT per determinare se il program- 
ma di scrittura di stampa differita per una particolare stampatrice, è avviato 
o interrotto. 


ALL specifica che devono essere avviati tutti i programmi di scrittura di 
stampa differita per tutte le stampatrici controllate. 
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numero modulo specifica il numero di modulo da usare dai programmi di 
scrittura di stampa differita; possono essere immessi da 1 a 4 caratteri. Ven- 
gono stampati soltanto i lavori che usano il numero di modulo specificato. 


FORMS specifica che il programma di scrittura di stampa differita deve stam- 
pare tutte le entrate del file di stampa differita disponibili che richiedono i 
moduli correntemente usati nella stampatrice, indipendentemente dalla posi. 
zione dell'entrata nel file di stampa differita. Dopo la stampa di tutte tali 
entrate, all'operatore che controlla la stampatrice viene richiesto di cambiare 
i moduli e vengono stampate tutte le entrate che usano il successivo gruppo 
di moduli. Ciò può ridurre il numero dei messaggi inviati all'operatore per 
cambiare i moduli. 


JOB specifica che devono essere avviati un lavoro o tutti i lavori che erano stati 
interrotti da un comando STOP JOB, JOB può essere immesso soltanto dal- 
la console di sistema o da una unità video di servizio di sistema. 


nome lavoro specifica il nome lavoro a 8 caratteri del lavoro da avviare. Può 
essere usato il comando STATUS USERS per determinare i nomi dei lavori. 


ALL specifica che tutti i lavori che erano stati interrotti da un comando 
STOP JOB devono riprendere l'elaborazione. 


JOBOQ o J specifica che possono essere elaborati tutti i lavori o i lavori con una 
priorità in coda lavori specifica dalla coda. Quando la coda lavori si svuota, 
l'esecuzione dei lavori inizia automaticamente quando nella coda vengono in- 
seriti uno o più lavori. JOBO o 4 possono essere immessi soltanto dalla con- 
sole di sistema o da una unità video di servizio di sistema. 

' 
ALL specifica che possono essere eseguiti tutti i lavori dalla coda dei lavori. 
Se non viene specificato alcun parametro, si presume ALL. 


FRS priorità in coda lavori specifica che possono essere avviati soltanto quei la- 
vori dalla coda dei lavori con la priorità in coda lavori specificata. E' possi- 
bile immettere qualsiasi numero da 0 a 5. 


nome lavoro indica che deve essere eseguito immediatamente uno specifico 
lavoro della coda lavori. Ciò non interessa l'elaborazione degli altri lavori cor- 
rettamente in esecuzione della coda lavori. 


SERVICE specifica che l’unità video specificata da id unità video deve diventare 
l'unità video di servizio di sistema, 


Nota: Questo parametro può essere immesso soltanto alla console di sistema. 
Inoltre se è attiva la riservatezza mediante parola d'ordine, è possibile speci- 
ficare SERVICE soltanto da un operatore che ha un'autorizzazione di sussi- 
dio di servizio. 


Occorre essere in grado di immettere i comandi dall'unità video specificata e 
cioè l’unità video non deve essere un'unità video immissione dati. 


Le procedure che possono essere eseguite presso qualsiasi unità video e da 
qualsiasi operatore, possono anche essere eseguite su una unità video di ser- 
vizio di sistema. Le procedure che possono essere eseguite da un operatore 
di sistema su qualsiasi unità video, possono essere eseguite su una unità vi- 
deo di servizio di sistema. Le procedure che possono essere eseguite soltan- 
to su una console di sistema, non possono essere eseguite su una unità video 
di servizio di sistema. Alcune procedure possono essere eseguite su qualsiasi 
unità video da qualsiasi operatore quando non è attiva la riservatezza me- 
diante parola d'ordine. Queste procedure possono sempre essere eseguite su 
una unità video di servizio di sistema, che sia o meno attiva la riservatezza 


mediante parola d'ordine. 
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E’ possibile eseguire tutti i comandi di controllo su una unità video di servi- 
zio di sistema salvo i seguenti: 


ASSIGN 

CANCEL SESSION per la console di sistema 
CONSOLE 

POWER 

START SERVICE 

START SYSTEM 

STOP SERVICE 

STOP SYSTEM 

VARY 


Se l’unità video di servizio di sistema è anche una console di sistema alterna- 
tiva, può essere usato il comando CONSOLE, Se l'unità video di servizio si- 
stema è un terminale a distanza, occorre stabilire un collegamento di comuni- 
cazione prima di poter usare l’unità video di servizio di sistema. Vedere il 
manuale Guida Operativa per ulteriori informazioni sulla creazione di un col- 
legamento di comunicazioni. 


SESSION o N riprende l’attività SSP-ICF che era stata interrotta da un comando 


STOP SESSION. 


Note: 
1. Seilsistema stava selezionando file a indici, a seguito di una richiesta di 


arresto selezione sort e un comando di avvio sistema, il sistema finirà di 
selezionare il file corrente e non selezionerà nessun altro file. 


2. Questo parametro può essere immesso soltanto sulla console di sistema. 


SYSTEM o S riprende l'attività di sistema che era stata interrotta da un comando 


di controllo STOP SYSTEM. 


Nota: Questo parametro può essere immesso soltanto sulla console di sistema. 


WORKSTN o W specifica che i lavori possono essere avviati e i comandi possono 


essere immessi da tutte le unità video {se è immesso ALL nella seconda posi- 
zione di parametro) o da una unità video specificata per la quale è stato im- 
messo il comando di controllo STOP WORKSTN. 


Nota: Questo parametro può essere immesso soltanto sulla console di sistema 
o su una unità video di servizio di sistema. 


id unità video specifica 1"ID a 2 caratteri dell'unità video da avviare. E’ possi- 
bile usare il comando STATUS WORKSTN per determinare gli ID delle unità 
video. 


ALL consente l'inizio dei favori e l'immissione di comandi interrotti da un 
comando di controllo STOP WORKSTN. 


e 


Esempio 1 


L'avvio di lavori dalla coda di lavori è stato interrotto da un comando di controi- 


lo STOP JOBO. Per iniziare l'esecuzione di un lavoro dalla coda dei favori, l’ope- 
ratore di sistema immette: 


START JOBQ 


Esempio 2 
L'avvio di tutti i lavori, compresi i lavori dalla coda di lavori e dal file di stampa 


differita, è stato interrotto da un comando di controllo STOP SYSTEM. Per con- 
sentire l’inizio dei lavori sul sistema, l'operatore deve immettere: 


SS 


Esempio 3 
Per avviare la stampatrice P3, l'operatore che la controlla, deve immettere: 


S P,P3 
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COMANDO DI CONTROLLO STATUS 


E’ possibile usare il comando di controllo STATUS per: visualizzare lo stato: 


Dalla propria sessione o da quella di un'altra unità video. 

Dei parametri della linea di comunicazioni del terminale video, 

Dei parametri della linea di comunicazioni del sistema. 

Dell’attività per una linea di comunicazioni. 

Dei lavori che sono stati inseriti nella coda dei lavori. 

Delle entrate del file di stampa differita. Vengono presentate tutte le infor- 
mazioni relative alle proprie entrate, Per le entrate di altri, non vengono vi- 
sualizzati l'ID del file di stampa differita, il nome di procedura, il nome del 
lavoro e il nome del file di stampa. 

Delle sessioni attive SSP-ICF. 

Dei sottosistemi SSP-ICF abilitati. 

Dei sottosistemi APPC abilitati. 

Delle locazioni MSRJE (immissione lavori a distanza in sessione multipla). 
Delle unità video, stampatrici e moduli a minidischi. 

Dei programmi di scrittura di stampa differita, 

Delle funzioni attive nel sistema e relativi indirizzi di blocco di funzione. 

Di un lavoro specifico o di tutti i lavori che vengono eseguiti sul sistema. 


Di una funzione di sistema. 


Dei messaggi cui non è stata data risposta su tutte le sottoconsole (unità vi- 
deo che controllano una stampatrice) o per una specifica sottoconsole. 


Se si controlla una o più stampatrici: è inoltre possibile usare il comando di con- 
trollo STATUS per visualizzare lo stato delle entrate del file di stampa differita 
per una specifica stampatrice o per tutte le stampatrici controllate. Vengono pre- 
sentate tutte le informazioni relative alle proprie entrate o alle entrate delle stam- 
patrici controllate. Per le entrate di altri o per quelle che non si riferiscono alle 
stampatrici controllate, non vengono visualizzati l'ID del file di stampa differita, 


il nome della procedura, il nome del lavoro e i nomi dei file di stampa. 


L'operatore di sistema o l'operatore dell'unità video di servizio di sistema: può 
usare il comando di controllo STATUS per visualizzare lo stato di: 


e  Tuttii lavori sulla coda dei lavori. 


e Tutte le entrate del file di stampa differita. Tutte le informazioni vengono 
visualizzate. 


Ogni schermata per il comando di controlio STATUS contiene due parti: la parte stato 
e la parte menù. Per una descrizione dettagliata delle informazioni che appaiono sulla 


schermata per il comando STATUS, premere il tasto RICH AIUTO. 
Ogni volta che viene visualizzata una informazione di stato, l'operatore può: 


e Terminare lo schermo di stato. 

e Visualizzare la successiva pagina delle informazioni di stato (se viene presen- 
tata l’ultima pagina, lo schermo di stato si ripristina alla prima pagina delle 
informazioni di stato). 

e Visualizzare la pagina precedente, 

e Immettere un comando o un'opzione di menù, 


e Ripristinare lo schermo di stato alla prima pagina delle informazioni di stato. 


e Richiedere uno schermo di stato aggiornato. 
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STATUS 
(D) 


SESSION, fida unità video] 
(8) 


COMM 
(c) 


COMONFIG 
(H) 


LINE, (numero 1 inea | 
(L) 


JOBQ,|nome lavoro| 
(J) 


PRT, lid stempatrice | 
(P) 


SUBSESS 
(N) 


SUBSYS 
(I) 


APPC, [nome ubicazione | 
(A) 


MSRJE, [rome locazione | 
(M) 


WORKSTN, |id unità video 
(W) id stampatrice 
Il 


TI 
T2 


WRT,|ia stampatrice ] 


SYSTASK,lnome lavoro 
(T) id funzione di sistema 


MESSAGE, [ia unità video | 
(G) 


USERS, [none levoro | 
(U) 
ALERT 





ZAN 


SESSIONE o $ visualizza informazioni relative alla sessione dell'unità video. Se 
non è specificato il primo parametro, si presume SESSION. Se non è speci- 
ficato un ID dell'unità video, viene indicato lo stato della propria unità video. 


id unità video specifica l'ID a 2 caratteri dell'unità video per la quale devono 
essere visualizzate informazioni di stato. 


COMM o C visualizza lo stato dei parametri della linea di comunicazioni dei ter- 
minali video. 


COMCNFIG o H visualizza lo stato dei parametri della linea di comunicazioni del 
sistema. 


LINE o L visualizza l'attività per una linea di comunicazioni. 


Numero linea specifica la linea in cui si deve visualizzare l'informazione di sta- 

to. Se non è specificato nessun parametro, è visualizzato lo stato della linea 1. 

JOBOQ o J visualizza un'entrata sulla coda dei ‘lavori. Se non è specificato alcun 
nome lavoro, vengono visualizzati tutti i lavori sulla coda. 


nome lavoro specifica il nome a 8 caratteri di un lavoro, nella coda dei lavori 
per il quale vengono visualizzate le informazioni di stato. 


PRT o P visualizza informazioni relative alle entrate del file di stampa differita. 
Se è specificato un ID di stampatrice, vengono visualizzate solo le entrate 
del file di stampa differita per quella stampatrice. Se non viene specificato 
alcun ID di stampatrice, vengono visualizzate le entrate del file di stampa dif- 


ferita per tutte le stampatrici. 


id stampatrice specifica |'1D a 2 caratteri delia stampatrice per la quaie devo- 
no essere visualizzate le informazioni del file di stampa différita. 


SUBSESS o N visualizza informazioni relative alle sessioni SSP-ICF attive. 


SUBSYS o i visualizza informazioni relative ai sottosistemi SSP-ICF abilitati. 


APPC 0 A visualizza lo stato di uno o di tutte le locazioni remote APPC attualmen- 


te abilitate. Se non è specificato un nome di locazione, è visualizzato lo stato di 
tutte le locazioni remote APPC. 


MSRJE o M visualizza lo stato di una o di tutte le locazioni MSRJE attualmente 
abilitate. Se non viene specificato alcun nome di locazione, vengono visualiz- 
zate tutte le informazioni di stato relative a tutte le locazioni MSRJE. 


nome locazione specifica il nome a 8 caratteri di una singola locazione 
MSRJE per la quale devono essere visualizzate informazioni di stato. 


WORKSTN o W visualizza informazioni di stato relative: 
e Alle stampatrici ed alle unità video focali e a distanza 
e Al moduloa minidischi. 
e Alle unità nastro, 


Se non viene specificato alcun parametro, viene presentato lo stato di tutte 
le unità. 
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id unità video specifica l'ID a 2 caratteri dell'unità video per la quale devono 
essere visualizzate le informazioni di stato. 


id stampatrice specifica l'ID a 2 caratteri della stampatrice per la quale devo- 
no essere visualizzate le informazioni di stato. 


11 specifica che devono essere visualizzate le informazioni di stato per il 
modulo a minidischi. 


T1 specifica che devono essere visualizzate le informazioni di stato per l’uni- 
tà nastro 1. 


T2 specifica che devono essere visualizzate le informazioni di stato per l'uni- 
tà nastro 2. 


TC specifica che devono essere visualizzate le informazioni di stato dell'unità 
nastro a cassetta. 


WRT visualizza lo stato dei programmi di scrittura del file di stampa differita. Se 
non viene specificato alcun ID di stampatrice, viene visualizzato lo stato di 
tutti i programmi di scrittura del file di stampa differita. 


id stampatrice specifica l'ID a 2 caratteri della stampatrice di cui deve essere 
visualizzato lo stato del programma di scrittura del file di stampa differita. 


SYSTASK o T visualizza le funzioni attive nel sistema e i relativi indirizzi di 
blocco di funzione. Se non è specificato un secondo parametro, viene visua- 
lizzato lo stato di tutte le funzioni attive. 


nome lavoro specifica il nome a 8 caratteri del lavoro per il quale vengono 
visualizzate informazioni di stato. 


id funzione di sistema specifica l'ID a 4 caratteri che identifica il blocco di 
funzione di una funzione di sistema. Per esempio il blocco di funzione del 
processore di comando potrebbe essere 0009. 

MESSAGE o G visualizza i messaggi cui non è stata data risposta da una o più 
sottoconsole. Se non viene specificato alcun ID di unità video, viene visua- 


lizzato lo stato di tutti i messaggi delle sottoconsole attive. 


id unità video specifica !"ID a 2 caratteri dell'unità video di sottoconsole per 
la quale devono essere visualizzati i messaggi informativi. 


USERS o U visualizza lo stato di un lavoro specificato o di tutti i lavori in ese- 
cuzione sul sistema. Se non viene specificato alcun nome di lavoro, viene 


visualizzato lo stato di tutti i lavori. 


nome lavoro specifica il nome a 8 caratteri del lavoro per il quale vengono 
visualizzate informazioni di stato. 


| ALERT visualizza lo stato delle ubicazioni di avviso attivate. 
Esempio 
Per visualizzare lo stato di tutti i lavori sul file di stampa differita: 
STATUS PRT 


oppure 


DP 
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COMANDO DI CONTROLLO STATUSF 


Si può usare il comando di controllo STATUSF per: 
Visualizzare lo stato di: 


e Lavori messi nella coda lavori 


®* Voci nel file di stampa differita. Tutte le informazioni sulle voci sono visualizzate. 
Se le voci non sono dell'utente che sta visualizzando, l'ID di stampa differita, il 
nome procedura, l’identificazione terminale, e l’identificazione utente non sono vi- 


sualizzate. 
* Terminali video, stampatrici, unità a minidischi e unità a nastri. 
€ Un lavoro particolare o tutti i lavori che sono attivi sul sistema. 


Se si controllano una o più stampatrici: si può anche usare il comando STATUSF per 
visualizzare lo stato di voci nel file di stampa differita per una stampatrice particolare 
o per tutte le stampatrici. Tutte le informazioni sulle voci dell'utente e le voci per le 
stampatrici che sì controllano sono visualizzate. Se le voci non sono dell'utente o non 
sono per le stampatrici che si controllano, l’identificazione di stampa differita, il nome 


della procedura, l’identificazione di terminale, e l'identificazione utente non sono visua- 


lizzate. 


Se l'utente è l'operatore di sistema: si può anche usare il comando STATUSF per visua- 
lizzare lo stato di: 


® Tutti i lavori nella coda lavori 

e Tutte le voci nel file di stampa differita. Tutte le informazioni sono visualizzate. 
Ogni schermata del comando STATUSF è piena di informazioni relative allo stato. Per 
ulteriori informazioni sulle informazioni della schermata, premere il tasto RICH AIUTO. 
Ogni volta che le informazioni di stato sono visualizzate, l'operatore può: 


e Terminare la visualizzazione 


® Visualizzare la pagina successiva di informazioni (se si sta visualizzando l’ultima 
pagina, la prossima pagina sarà la prima) 


* Visualizzare la pagina precedente. 
e Immettere un comando. 
e Ottenere la prima pagina di informazioni 


e Richiedere una visualizzazione aggiornata. 
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STATUSF 
(DF) 


JOBQ, | nome Lavoro | 
(JI) 


PRT, | id stampatzice 
(P) 


WORKSTN,|i1d terminale 
(w  |ia stampatrice 
Il 


TI 
T2 


USERS, [rome Lavoro] 
(U) 





JOBO o J visualizza le voci nella coda lavori. Se non è specificato un nome lavoro, sono 
visualizzati tutti i lavori. 


nome lavoro specifica il nome di 8 caratteri del lavoro, nella coda lavori, di cui si 
devono visualizzare le informazioni. 


PRT o P visualizza le informazioni di voci nel file di stampa differita. Se è specificata 
una identificazione di stampatrice, sono visualizzate solo le voci di stampa differita per 


quella stampatrice. Se non è specificata nessuna identificazione, sono visualizzate le- 


voci relative a tutte le stampatrici. 


id stampatrice specifica una identificazione di 2 caratteri della stampatrice di cui si vo- 
gliono visualizzare le informazioni del file di stampa differita. 


ATA 


WORKSTN o W visualizza informazioni di stato circa: 


I terminali remoti e locali e le stampatrici 
L'unità a minidischi 


L'unità a nastri 


Se non è fornito un secondo parametro, è visualizzato lo stato di tutte le unità. 


id terminale specifica l’identificazione di due caratteri del terminale di cui si voglio- 
no visualizzare le informazioni di stato. 


id stampatrice specifica l’identificazione di 2 caratteri della stampatrice di cui si 
vogliono visualizzare le informazioni di stato. 


11 specifica che devono essere visualizzate le informazioni di stato dell'unità a mini- 
dischi. 


T1 specifica che devono essere visualizzate le informazioni di stato dell'unità a na- 
stri 1. 


T2 specifica che devono essere visualizzate le informazioni di stato dell'unità a na- 
stri 2. 


TC specifica che devono essere visualizzate le informazioni di stato dell'unità 
nastro a cassetta. 


USERS o U visualizza lo stato di un lavoro specifico o di tutti i lavori attivi nel sistema. 


Se non è specificato un nome di lavoro, è visualizzato lo stato di tutti i lavori. 


nome lavoro specifica il nome di 8 caratteri del lavoro di cui si vogliono le informa- 
zioni di stato. 
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COMANDO DI CONTROLLO STOP 
Se si controllano una o più stampatrici: è possibile usare il comando di controllo 
STOP per interrompere la stampa di tutte le entrate del file di stampa differita 
per una stampatrice specificata o per tutte le stampatrici controllate, La stampa 
può essere interrotta immediatamente, al termine della pagina di stampa corrente 
o al termine dell'entrata del file di stampa differita correntemente in stampa. 


L'operatore del sistema o l'operatore dell'unità video di servizio di sistema: può 
anche usare il comando di controllo STOP per: 


e Interrofnpere la stampa di tutte le entrate nel file di stampa differita per una 
qualsiasi o per tutte le stampatrici. 


e Interrompere l'elaborazione di un lavoro specificato o di tutti i lavori. 
e Interrompere l’elaborazione dei lavori dalla coda dei lavori. 


e Far cessare che un'unità video venga usata come unità video di servizio di si- 
stema (ciò può essere eseguito soltanto dalla console di sistema). 


e Impedire l’inizio dei lavori in arrivo da sessioni SSP-ICF. 


e Iniziare un arresto ordinato dal sistema con o senza la selezione delle chiavi 
per l'indice (ciò può essere eseguito soltanto dalla console di sistema). 


e Impedire l'avviamento di lavori da tutte ie unità video diverse dalla console 
di sistema o impedire l'avviamento dei lavori da una unità video specificata. 


Il comando STOP SYSTEM non è ammesso se sono abilitati i sottosistemi SSP- 
ICF. 
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PRT,|jid stampatrice »| PAGE 
(P) |stampatrice di sistema| | JOB 
ALL 


JOB,fnome Leni 
ALL 


JOBQ,| ALL 
(J) |priorità in coda lavori 


SESSION 
(N) 


SERVICE,id unità video 


SYSTEM, | SORT 
(Ss) NOSORT 


(W) ALE 


WORKSTN, ta unità E) 





PRT o P interrompe la stampa dei lavori sul file di stampa differita. Se viene 
stampato un lavoro e non è specificato un terzo parametro, la stampa s’in- 
terrompe immediatamente. E’ possibile riprendere la stampa immettendo il 
comando START-PRT oppure il comando RESTART. 


id stampatrice specifica l'ID a 2 caratteri della stampatrice per ta quale deve 
essere interrotto il programma di scrittura del file di stampa differita. Se 
non è specificato alcun ID di stampatrice, si presume la stampatrice di siste- 
ma. 


ALL specifica che la stampa deve interrompersi per tutte le stampatrici con- 
trollate. 


PAGE interrompe il programma di scrittura del file di stampa differita quan- 
do ha completato la stampa della pagina corrente. 


JOB interrompe il programma di scrittura del file di stampa differita quando ha 
completato la stampa della copia corrente delle entrate del file di stampa differita. 
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JOB interrompe l'esecuzione di tutti i lavori o interrompe l'esecuzione di un la- 
voro specificato. Questo parametro può essere immesso soltanto dalla con- 
sole di sistema o da una unità video di servizio di sistema. Il comando STOP 
JOB può essere usata per: 


e interrompere un lavoro che sembra avere il contrallo del sistema. 


e Interrompere tutti i lavori per eseguire un lavoro importante o un lavo- 
ro che non può essere eseguito contemporaneamente ad altri lavori. 


nome lavoro specifica il nome a 8 caratteri del lavoro da interrompere. Può 
essere usato il comando STATUS USERS per determinare i nomi dei lavori. 


ALL specifica che devono essere interrotti tutti i lavori in esecuzione. 


JOBOQ 0 J impedisce l'avviamento dalla coda lavori di tutti i lavori o dei lavori 
con una priorità di coda lavori specificata. Il lavoro che è già in esecuzione 
continua fino al termine. 


Nota: Questo parametro può essere immesso soltanto dalla console di sistema 
o da una unità video di servizio di sistema. 


ALL specifica che tutti i lavori nella coda dei lavori non possono essere av- 
viati. 


priorità in coda lavori specifica una priorità di coda lavori; si tratta di un nu- 
mero da 0 a 5, Deve essere impedito l'avviamento di tutti i lavori con la 
priorità di coda lavori specificata. 


SESSION o N impedisce l'avviamento di lavori in arrivo dalle sessioni SSP-ICF. 


Nota: Questo parametro può essere immesso soltanto dalla console di sistema 
o da una unità video di servizio di sistema. 


SERVICE fa sì che venga a cessare l'uso di una unità video come unità video dî 
servizio di sistema. 


Nota: Questo parametro può essere immesso soltanto dalla console di sistema. 


id unità video specifica l'ID a 2 caratteri di una unità video che deve cessare 
di venire usata come unità video di servizio di sistema. 

Se l’unità video di servizio di sistema è un terminale a distanza, può essere 
necessario terminare il collegamento di comunicazioni verso que! terminale a 
distanza. Vedere il manuale Guida Operativa per ulteriori informazioni sulla 
conclusione di un collegamento di comunicazioni. 
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SYSTEM. o S fa sì che inizi un arresto ordinato delle attività del sistema. Questo 


parametro può essere immesso soltanto dalla console di sistema, Il comando 
STOP SYSTEM non è ammesso se sono abilitati sottosistemi SSP-ICF. 


SORT specifica che devono essere selezionate le chiavi a indici come parte 
della procedura per l'arresto del sistema. Dal sistema verranno selezionati sol- 
tanto i file a indici con una grande area di eccedenza per le chiavi. Se si desi- 
dera forzare la selezione di uno specifico file a indici fare riferimento alla 
Procedura KEYSORT. Se viene specificato SYSTEM come primo parametro 
ed il secondo parametro non è specificato, viene assunto SORT. 


NOSORT specifica che non devono essere selezionate le chiavi per l'indice. 
STOP SYSTEM fa sì che si verifichi quanto segue: 

Per ciascuna operazione di immissione di unità video in un programma, al 
programma, insieme ai dati, viene ritornato un codice di condizione che in- 
dica che è stato immesso un comando di controllo STOP SYSTEM. | pro- 
grammi devono controliare la presenza di questa condizione, chiudere tutti i 
file e portarsi alla fine del lavoro al più presto possibile, 


Dopo che il sistema si è fermato: 


e Gli operatori alle unità video non possono avviare i lavori o immettere 
il comando JOBO, 


e Sulla console di sistema, l'operatore di sistema può avviare nuovi lavori 
e può immettere tutti i comandi salvo STOP WORKSTN. 


WORKSTN o W impedisce l'avvio di lavori e l'elaborazione di taluni comandi di 


controllo da tutte fe unità video salvo la console di sistema. Tutti i lavori 
correntemente in esecuzione continuano l'esecuzione, Se viene immesso un 
ID di unità video nella seconda posizione di parametro, viene impedito sol- 
tanto l'avviamento dei lavori dall'unità video specificata. 


Nota: Questo parametro può essere immesso soltanto dalla console di siste- 
ma o da una unità video di servizio di sistema. 


id unità video specifica l'ID a 2 caratteri dell'unità video dalla quale non 
possono essere avviati nuovi lavori. 


ALL specifica che non devono essere avviati nuovi lavori. Inoltre, non è 
ammesso il comando di controllo JOBOQ. 


Esempio 1 
L'operatore di sistema si sta preparando a fermare il sistema. Per interrompere 
l’inizio di lavori dall'unità video, dalla coda dei lavori e dal file di stampa diffe- 


rita e per selezionare le chiavi per l‘indice, l'operatore di sistema immette: 


STOP SYSTEM 


Esempio 2 


Per interrompere la stampa della stampatrice P3, l'operatore che la controlla deve 
immettere: 


STOP PRT,P3 
oppure 


P_P,P3 
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TIME 


COMANDO DI CONTROLLO TIME 


E” possibile usare il comando di controllo TIME per: visualizzare l'ora del giorno 
e la data di sistema. L'ora è basata su quella specificata dall'operatore di sistema 
durante l’IPL ed è visualizzata nel formato seguente: 
hh:mm: 55 
hh specifica le ore, 
mm specifica i minuti. 
ss specifica i secondi. 
La data di sistema viene visualizzata nel formato della data di sistema: 
mmggaa, ggmmaa, o 2aMmgg 
mm specifica il mese, 
gg specifica il giorno. 
aa specifica l’anno. 


Quando l'ora passa da 23:59:59 a 00:00:00, avanza anche la data di sistema, 


Il comando TIME non ha parametri. 


Esempio 


Per visualizzare l'ora del giorno e la data del sistema, l'operatore immette: 


TIME 


COMANDO DI CONTROLLO VARY 


L'operatore di sistema può immettere il comando di controllo VARY dalla con- 
sole di sistema per modificare lo stato di quanto segue da “in linea” a ‘’fuori li- 


nea” e da ‘’fuori linea” a ‘‘in linea”. 


Il comando VARY non può essere immesso da una unità video di servizio di 


e Unità video 

e Stampatrici 

e Stampatrice di sistema 

e Modulo a minidischi 

e Unità di controllo di comunicazione. 
e Linea di comunicazioni. 

e Unità nastro. 

sistema. 


Le unità che sono fuori linea non possono essere usate dagli operatori o dai pro- 
grammi. ll comando VARY non può essere usato per porre fuori linea una unità 
che è allocata ad un programma o collegata a meno che non si sia verificato un 
errore di immissione/emissione sull'unità. 


E’ possibile usare il comando STATUS. WORKSTN per determinare lo stato cor- 


rente delle unità sul sistema. 
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VARY 
(V) 
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ON 
OFF 


id terminale 
id stampatrice 


PRT 
(P) 


I 


id unità di controllo 

,«numero linea | 

id unità di controllo, numero linea 
TI 

T2 

TC 





ON fa sì che l’unità specificata venga posta in linea. 
OFF fa sì che l’unità specificata venga posta fuori linea. 


id unità video specifica l'ID a 2 caratteri di un'unità video da porre in linea o 
fuori linea. E’ possibile usare il comando STATUS WORKSTN per determi- 
nare gli ID delle unità video. 


Una unità video deve essere scollegata per poter essere posta fuori linea. Se 
l'unità che viene posta fuori linea è una sottoconsole, qualsiasi messaggio in- 
viato alla sottoconsole viene inviato alla console di sistema. 


id stampatrice specifica l'ID a 2 caratteri della stampatrice da porre in linea o 
fuori linea. E’ possibile usare il comando STATUS WORKSTN per determi- 


nare gli ID di stampatrice. 


| programmi di scrittura in stampa differita per una stampatrice devono es- 
sere interrotti e compietati per poter porre quella stampatrice fuori linea. E’ 
possibile usare il comando STATUS WRT per determinare se un programma 


di scrittura in stampa differita è interrotto o completato. 


PRT o P specifica che la stampatrice di sistema deve essere posta fuori linea o in 
finea. 


11 specifica che il modulo a minidischi deve essere posto in linea o fuori linea. 
T1 specifica che deve essere inserita in linea o messa fuori linea l’unità nastro 1. 


T2 specifica che deve essere inserita in linea o messa fuori linea l'unità nastro 2. 


TC specifica che l’unità nastro a cassetta deve essere posta in linea o fuori linea. 


STA 


id unità di controlla specifica l'ID a 3 caratteri di una unità di controllo di co- 
municazioni. Tutte le unità video e le stampatrici a distanza associate con 
l’unità di controllo specificata sono poste in linea o fuori linea. 


numero linea specifica il numero delta linea di comunicazioni. Quando viene immesso 
questo parametro senza il parametro ID dell'unità di controllo, tutte le unità di con- 
trollo, le unità video e le stampatrici associate con questa linea sono poste in linea 
0 fuori linea. Quando questo parametro viene immesso con i! parametro ID deli’uni- 
tà di controllo sul comando VARY ON, l’unità specificata viene posta in linea sulla 


linea specificata. 


id unità di controlio,numero linea è valido soltanto per le linee di comunicazioni 
commuta*te. Quando questi parametri sono immessi su un comando VARY 
ON, l’unità specificata viene posta in linea sulla linea specificata. 


Esempio 


Per porre in linea tutte le unità video e ie stampatrici a distanza associate con 
l'unità di controllo C01, l'operatore deve immettere: 


VARY ON,COl 
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Appendice A. Programma di Utilità SSP 


Questa Appendice illustra i programmi di utilità SSP che è possibile usare in luo- 
go delle procedure SSP. |! programmi di utilità sono presentati in ordine alfabeti- 
co di programma, unitamente alla descrizione delle funzioni che possono essere 
eseguite dal programma stesso ed alle specifiche di controllo programma di utilità 
e specifiche OCL che possono essere usate per eseguire quella funzione. 


CREAZIONE DI PROPRIE PROCEDURE CON L'USO DEI PROGRAMMI 
DI UTILITA’ SSP 


Questa sezione descrive il motivo per cui talvolta si desidera creare proprie proce- 
dure dai programmi di utilità SSP. Creando proprie procedure basate sulle specifi- 
che indicate, è possibile indicare specifiche OCL per modificare il modo in cui 
vengono eseguite le procedure stesse. Per esempio: 


e E’ possibile indicare date diverse di passo di lavoro o di lavoro usando la spe- 
cifica OCL DATE. Vedere la Specifica OCL DATE per ulteriori informazioni 
sulla modifica della data. 


e E’ possibile indicare tipi diversi di ritenzione dei file su disco usando la spe- 
cifica OCL FILE. Vedere la Specifica OCL FILE (per i file su disco) per ul- 
teriori informazioni sui tipi di ritenzione dei file su disco. 


e E’ possibile indicare istruzioni speciali per la stampatrice usando la specifica 
OCL PRINTER. Vedere la Specifica OCL PRINTER per ulteriori informa- 
zioni sulla specifica di informazioni per stampatrice. 


Questa sezione mostra un esempio delle specifiche che è possibile usare invece 
della procedura fornita. 
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Esempio 


Questo esempio mostra come è possibile creare una propria versione della proce- 
dura LISTLIBR per far sì che l'emissione venga stampata con priorità 0. Questa 
priorità fa sì che l'emissione venga congelata sul file di stampa differita fino a 
che non venga specificamente rilasciata per la stampa. E’ possibile, ad esempio, 
eseguire questa procedura campione e quindi eseguire la procedura COPYPRT 
per visualizzare l'emissione. 


ll nome della procedura è LSAMPLE. Se si vuole provarla, occorre immetterla 
in un membro di procedura di libreria. Vedere Specifiche di procedura LISTLIBA: 
Programma di utilità $MAINT e Specifica OCL PRINTER per informazioni sulle 
specifiche usate in questa procedura. 


* LSAMPLE procedura 
// LOAD $MAINT 
// PRINTER NAME-$SYSLIST sSPOCL- YES, PRIORITY-0 


// RUN | 

// COPY TO-FRINT,NAME-?1R? ,LIBRARY-?2'? ,FROM-?3'?CLIB?!? 

// END 

// RETURN 

* 

* Procedura campione (basata sulla procedura LISTLIPR) 

* 

* Parametro Entrata Significato 

ZII a, n ce Aia ile Malt 

* Parametro l: nome membro Nome membro da listare 

* DIR Lista dell'indirizzario di libreria 

* ALL Lista di tutti i membri 

* triade ni ERI AI ria 

* Parametro 2: S Lista di membri origire (assunta 
per difetto) 

* P Lista dei membri di procedura 

* 0 lista dei membri oggetto 

* R Lista dei membri di sottoroutine 

* ALL Lista dei membri di tutti i tipi 

Acea li de dii (ie eri tetra 

* Parametro 3: nome libreria Si assume la libreria corrente 


Le specifiche nella procedura LSAMPLE indicano quanto segue: 


. * » e . «oo x 
*: Un asterisco (*) nella prima colonna indica che la specifica è un commento, 


Qualsiasi informazione che segue l'asterisco non viene elaborata. 


LOAD indica che sarà caricato il programma di utilità $MAINT. 


Pa 


n 


PRINTER indica il modo in cui deve essere modificata l'emissione di lista di si- 
stema stampata da $MAINT, Il parametro NAME-$SYSLIST indica che 
l'emissione di lista di sistema deve essere modificata dalla specifica; il para- 
metro SPOOL-YES indica che l'emissione di lista di sistema deve essere stam- 
pata in differita. Il parametro PRIORITY-0 fa sì che l'emissione venga con- 
gelata sul file dì stampa differita; cioè l'emissione non viene stampata fino a 
che non è rilasciata (ad esempio, usando il comando RELEASE). 


RUN indica che deve iniziare l'esecuzione del programma $MAINT legge quindi 
le specifiche COPY e END. 


COPY indica che sarà listato il membro di libreria specificato o l'indirizzario (se 
viene specificato DIR). 


END indica la fine delle specifiche di controllo dei programma di utilità $SMAINT. 


RETURN: La procedura termina. Le specifiche di commento seguenti non sono 
elaborate dal sistema. 


Per eseguire la procedura LSAMPLE, immetterla per prima in un membro di pro- 
cedura di libreria denominato LSAMPLE usando il SEU. Non occorre immettere 
le specifiche di commento (*). Dopo aver immesso la procedura, è possibile ese- 


guirla. Per esempio, per listare un membro origine di libreria denominato TEST 
da una libreria denominata MYLIB, occorrerebbe immettere: 


LSAMPLE TEST,MYLIB 
Per listare l’indirizzario della libreria MYLIB occorrerebbe immettere: 


LSAMPLE DIR, ALL,MYLIB 
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PROGRAMMA DI UTILITA’ $ARSP | 


Il programma di utilità $SARSP cambia i valori di risposta automatica ed i livelli 
di gravità in un membro oggetto messaggi. Vedere la Procedura RESPONSE per 
ulteriori informazioni. 


// LOAD $ARSP 
// RUN 


// RESPONSE SOURCE-nome membro origine |,LIBRARY-(nome libreria 
#LIBRARY 


// END 





Esempio 


‘ Per applicare le risposte automatiche contenute nel membro origine di libreria 
denominato AUTORESP (che è memorizzato in una libreria denominata MYLIB): 


// LOAD $ARSP 
// RUN 
// RESPONSE SOURCE-AUTORESP,LIBRARY-MYLIB 


// END 
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PROGRAMMA DI UTILITA’ $BICR 


Il programma di utilità $B!ICR consente di: 


Listare un file di interscambio | o in formato base di interscambio su minidi- 
sco (procedura LISTFILE). 


Convertire un file su minidisco in formato interscambio | o in formato base 
di interscambio in un file su disco a indice o sequenziale (procedura TRAN- 
SFER). 


Aggiungere un file su minidisco (in formato base di interscambio o formato 
di interscambio 1) ad un file su disco sequenziale esistente (procedura TRAN- 


SFER). 


Convertire un file su disco o aggiungere record da un file su disco ad un file 
su minidisco in formato base di interscambio base (procedura TRANSFER). 
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Lista di file su minidisco (Procedura LISTFILE) 
Per ulteriori informazioni vedere la Procedura LISTFILE. 
// LOAD $BICR 


// FILE NAME-COPYIN,LABEL-nome file di immissione UNIT-Il 
// RUN 


// DISPLAY | FROM-primo record [.To-u1timo record] 


// END 





Per la specifica OCL FILE sono presentati soltanto alcuni dei parametri. Per 
informazioni sulla specifica OCL FILE, vedere la Specifica OCL FILE (per i 
file su minidisco) e la Specifica OCL FILE (per i file su disco). 


La specifica DISPLAY fa sì che il file venga listato sull'unità di lista di sistema. 
E' posibile usare il comando SESSION STATUS per determinare qual'è l’unità 
di lista del sistema. 


FROM-primo record specifica il primo record da visualizzare. Se non è indicato 
FROM, il file viene listato iniziando dal primo record. 


TO-ultimo record specifica l’ultimo record da visualizzare. Se non è specificato 
TO, il file viene listato terminando con l’ultimo record. Il valore massimo 
che può essere specificato è 8000000. 


Esempio 


Per listare un file su minidisco in formato base di interscambio denominato 
BASICDAT: 


// LOAD $BICR 

// FILE NAME-COPYIN, LABEL-BASICDAT,UNIT-Il 
// RUN 

// DISPLAY 

/} END 
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Copia di file (Procedura TRANSFER) 


Per ulteriori informazioni vedere la Procedura TRANSFER. 


. // LOAD $BICR 
// FILE NAME-COPYIN,LABEL-nome file di dc 
Il 


// FILE NAME-COPYO,LABEL-nome file d'emissione sa 
Il 


// RUN 


— 


// TRANSFER sui: } |.grnEN-1unghezze chiave ,KEYLOC-locazione ctriove | 
YES 


sFORMAT- fEXCHANGE : 
IFORMAT 





Sono presentati soltanto alcuni dei parametri per la specifica OCL FILE. Per in- 
formazioni sulla specifica OCL FILE, vedere la Specifica OCL FILE (per i file 
su minidisco) e la Specifica OCL FILE (per i file su disco). 


Esempio 1 


Per creare un file sequenziale su disco denominato FILE2 da un file in formato 
di interscambio | o da un formato base di interscambio su minidisco denominato 
FILE2: 


// LOAD $BICR 

// FILE NAME-COPYIN,LABEL-FILE2,UNIT-I1 
// FILE NAME-COPYO,LABEL-FILE2,UNIT-F1 
// RUN 

// TRANSFER 

// END 


Esempio 2 


Per creare su disco un file a indice denominato FILE2 da una file base di inter- 
scambio denominato FILE2 (la chiave deve essere nella posizione da 1 a 5): 


// LOAD $BICR 

// FILE NAME-COPYIN,LABEL-FILE2,UNIT-Il 
// FILE NAME-COPYO,LABEL-FILE2,UNIT-F1 
// RUN 

// TRANSFER ADD-NO,KEYLEN-5,KEYLOC-1 

// END 
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Esempio 3 


Per aggiungere un file su minidisco in formato di interscambio | o in formato 
base di interscambio denominato FILE1 ad un file su disco esistente denominato 


FILE1: 


// 
// 
(I 
// 
// 
o 


Esempio 4 


LOAD $BICR 


FILE NAME-COPYIN,LABFL-FILE1,UNIT-Il 
FILE NAME COPYO,LABEL-FILEl,UNIT-F1 
RUN e 

TRANSFER ADD-YES 

END 


Per creare un file su minidisco in formato di interscambio | denominato FILE3 
su un minidisco da un file su disco denominato FILE3 (tenendo presente che il 
file deve essere conservato per 30 giorni e che 1"ID del minidisco è VOL002: 


// 
/] 
pà 


ali 
‘Dj 
/] 


LOAD $BICR 








FILE NAME-COPYIN,LABEL-FILE3,UNIT-F1 

FILE NAME COPYO,LABEL-FILE3,UNIT-I1,PACK-VOL002, 
RETAIN-30 

RUN 

TRANSFER FORMAT-IFORMAT 

END 


PROGRAMMA DI UTILITA’ $BMENU 


Il programma di utilità $BMENU crea due membri di libreria richiesti per visua- 
lizzare un menu. Vedere la Procedura BLDMENU per ulteriori informazioni. 


LIBRLIBR membro origine di libreria,membro oggetto di libreria,SOURCE, 
nome menù##, REPLACE 


LIBRLIBR membro origine di libreria,membro oggetto di libreria,SOURCE, 
nome membro testo, ,REPLACE 


REMOVE nome menù##,LOAD,membro oggetto di libreria 
REMOVE nome membro testo,LOAD,membro oggetto di libreria 


CREATE nome menù##,,membro oggetto di libreria 
[creme nome membro testo, membro oggetto di libreria | 


// LOAD $BMENU 
// RUN 


Y] 





// MENU INPMSG-nome mend## | MENMSG-nome membro testo| EEE 


sINLIB-fmembro oggetto di libreria , FREEFORM- f no 
#LIBRARY YES 


// END 


REMOVE nome membro testo,LOAD,membro oggetto di libreria 
REMOVE nome menù, SOURCE,membro oggetto di libreria 
REMOVE nome membro testo,SOURCE,membro oggetto di libreria 


ì 
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Esempio 


Si è creato un membro origine di comando denominato MENU## ed un membro 
origine di testo video denominato MENUDT; entrambi i membri sono memoriz- 
zati in una libreria denominata MYLIB. Per costruire un menu denominato 
MENU, usando la procedura BLDMENU, occorre immettere quanto segue. | 
membri di libreria creati da BLDMENU devono essere inseriti in una libreria de- 
nominata MYLIB ed il membro oggetto del testo video creato da BLDMENU 
deve essere cancellato da MY LIB prima che BLDOMENU termini. 


CREATE MENU##, ,MYLIB 

CREATE MENUDT, ,MYLIB 

// LOAD $BMENU 

// RUN 

// MENU INPMSG-MENU## ,MENMSG-MENUDT, INLIB-MYLIB, 
REPLACE-NO , FREEFORM-NO 

// END 

REMOVE MENUDT,LOAD,MYLIB 


688 


PROGRAMMA DI UTILITA’ $BUILD 


Il programma di utilità $BUILD visualizza i dati sul disco dopo un errore disco. 
E’ possibile in tal modo correggere i dati visualizzati. Per ulteriori informazioni 
vedere la Procedura BUILD. 








// SWITCH XXXXXXXO 
// LOAD $BUILD 

// PRINTER NAME-$SYSLIST,SPOOL-NO 
// RUN 


[c OMPRESS ] 










Esempio 


Per controllare un file dopo un errore di immissione/emissione file su disco, oc- 
correrebbe immettere quanto segue: 


// SWITCH XXXXXXXO 
// LOAD $EUILD 

// PRINTER NAME-$SYSLIST,SPOOL-NO 
// RUN 
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PROGRAMMA DI UTILITA’ $COPY 


II programma di utilità $COPY consente di: 


Copiare file su disco (procedura COPYDATA) 


Listare file su nastro, su minidisco o su disco (procedure LISTDATA e 
LISTFILE). 


Ripristinare l’indirizzario di risorse di rete da minidisco o nastro (Procedura RESTNRD) 
Salvare file su disco, su minidisco o su nastro (Procedura SAVE). 


Salvare l'indirizzario di risorse di rete su minidisco o nastro (procedura SAVENRD). 


In questa sezione figurano anche le specifiche di controllo programma di utilità 
$COPY supportate per compatibilità con il Sisterma/34 IBM. 


Copia di file su disco (Procedura COPYDATA) 


Per ulteriori informazioni vedere la Procedura COPYDATA. 


/} LOAD $COPY 


// FILE NAME-COPYIN,LABEL-copiare da nome file,UNIT-F1 
// FILE NAME-COPYO,LABEL-copiare su nome file ,UNIT-F1 


// RUN 


// COPYFILE |OUTPUT-{ SAME sf INCLUDE\-{ EQ |PoStETON-posizION 
SEQUENTL OMIT NE Fa 


(5) 
INDEXED 
(I) 
DIRECT 
(D) 


iii dui > } | arci-Lunenezza recora | 


Xdddd...dd YES 


[porro massimo dei recorà | 


// SELECT f RECORD|,FROM-valore iniziale |.r0-valore finale | 


KEY 
PKY 


0) KEY POSITION-posizione chiave,LENGTH-lunghezza chiave | 


// END 
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Sono indicati soltanto alcuni dei parametri per la specifica OCL FILE. Per ulte- 
riori informazioni sulla specifica FILE, vedere la Specifica OCL FILE (per i file 


su disco). 


Differenze dai Parametri di Procedura 


Per la specifica COPYFILE: 


CHAR- caratteri’ consente di specificare un massimo di 30 caratteri di dati. | dati 
devono iniziare e terminare con apice ('). Inoltre è possibile specificare apici 
nella stringa di caratteri immettendo due apici, Per esempio, l'orologio ver- 
rebbe immesso nella forma ‘l’’orologio’. 


Xdddd...dd può specificare anche i caratteri di confronto. Questa forma specifica 
dati esadecimali. E’ possibile specificare fino a 15 byte, dove 2 cifre (dd) 
rappresentano il byte esadecimale. Le cifre esadecimali vanno da 0 a 9 e da 
A a F. La X deve precedere le cifre esadecimali. 


La specifica SELECT consente di definire ulteriormente i record da copiare. 


RECORD specifica che deve essere copiata una porzione del file. Quando viene 
specificato RECORD, i parametri FROM e TO (se viene usato TO) devono 
specificare i numeri relativi di record. 


FROM-valore iniziale specifica il numero di record relativo del primo record 
da copiare. Per esempio, se il primo record da copiare è il quinto nel file, 
occorre specificare FROM-5. Se deve essere copiato o visualizzato un solo 
record, i parametri FROM e TO devono specificare lo stesso numero relativo 
di record. 


ll valore FROM deve essere minore di o uguale al valore TO. 


TO-valore finale specifica il numero relativo dell'ultimo record da copiare. 
Per esempio se l'ultimo record da copiare è il quindicesimo nel file, occorre 
specificare TO-15. Se deve essere copiato o visualizzato un solo record, i pa- 
rametri FROM e TO devono specificare lo stesso numero relativo di record. 
Se non viene specificato un valore finale, il file viene copiato fino all'ultimo 
record nel file. 


Il valore TO deve essere maggiore di o uguale al valore FROM. 


KEY o PKY specifica che deve essere copiata una porzione specificata di un file 
a indice. Occorre specificare PKY quando il file a indice contiene chiavi com- 
presse. Se vengono usate chiavi normali, è possibile specificare un massimo di 
120 caratteri. Se vengono usate chiavi compresse, è possibile specificare fino a 
239 caratteri. 


FROM-valore iniziale specifica la chiave (o i caratteri iniziali della chiave) del 
primo record da copiare. | caratteri devono essere racchiusi tra apici (’)..Se 
nessuna delle chiavi nel file inizia con i caratteri specificati, il primo record 
da copiare o visualizzare è quello con la chiave più elevata. Per esempio, se 
viene specificato FROM-'NAME1’, ia prima chiave che inizia con NAME1 o 
un valore maggiore è la chiave de! primo record da copiare. 


Il valore FROM deve essere minore di o uguale al valore TO. Se deve essere 
copiato soltanto un record, i parametri FROM e TO devono specificare la 


stessa chiave. 
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TO-valore finale specifica la chiave (o i caratteri iniziali della chiave) dell’ul- 
timo record da copiare. Il valore finale deve essere racchiuso tra apici (’). 


Il valore TO deve essere maggiore del valore FROM o uguale ad esso. 


Se nessuna delle chiavi nel file inizia con i caratteri specificati, il record con 
la successiva chiave inferiore è l'ultimo da copiare. Per esempio, se viene spe- 
cificato TO-‘34', l'ultima chiave che inizia con 34 (oppure se nessuna chiave 
inizia con 34, l’ultima chiave che inizia con un valore minore di 34) è la 
chiave dell'ultimo record da copiare. 


Se non è specificato il parametro TO, $COPY usa l’ultima chiave nell'indice 
come chiave TO. Se deve essere copiato o visualizzato un solo record, i para- 
metri FROM e TO devono specificare la stessa chiave. 


Esempio 1 


Questo esempio mostra come copiare FILE1 e creare una copia esatta di esso, 
FILE2. 


// LOAD $COPY 

// FILE NAME-COPYIN,UNIT-F1,LABEL-FILEl 
// FILE NAME-COPYO,UNIT-F1,LABEL-FILE2 
// RUN 

// COPYFILE 

// END 


Esempio 2 


Questo esempio mostra come copiare un file denominato FILE1, che è un file 
a indice e come creare un nuovo file denominato FILE3. II nuovo file deve essere 
un file a indice e la chiave deve essere nella posizione da 5 a 24. 


//,LOAD $COPY 

// FILE NAME-COPYIN,UNIT-F1,LABEL-FILEl 
// FILE NAME-COPYO,UNIT-F1,LABEL-FILE3 
// RUN 

// COPYFILE OUTPUT-INDEXED 

// KEY POSITION-5,LENGTH-20 

// END 


Esempio 3 


Questo esempio mostra come usare la specifica SELECT per copiare soltanto quei 
record che hanno numeri relativi di record 2,3 e 4. 


// LOAD $COPY 

// FILE NAME-COPYIN,UNIT-F1,LABEL-FILEl 
// FILE NAME-COPYO,UNIT-F1,LABEL-FILE7 
// RUN 

/} COPYFILE 

// SELECT RECORD,FROM-2,T0-l 

// END 


| LISTA DI FILE $COPY (PROCEDURE LISTDATA/LISTFILE) 


Per ulteriori informazioni vedere la Procedura LISTDATA. 


// LOAD $COPY 
// FILE NAME-COPYIN,LABEL-nome file d'immissione,UNIT-(Fl 


Il 
TI 
T2 
// RUN 
// COPYFILE OUTPUT-fCHAR s{ INCLUDE |-{ EQ |.POsITION-pOsi zione | 
HEX OMIT NE 
PARTHEX LT 
CRT LE 
GT 
GE 


sCHAR-f'caratteri' sREORG- fNO |,REcL-1unghezza record | 
xdddd...dd YES ll 


È LIMIT-record mass imi | 


// SELECT { RECORD ,FROM-valore iniziale [1t0-valore finale | 
KEY ” © 
PKY 


// END 


Per ulteriori informazioni sulla specifica FILE, vedere la Specifica OCL FILE (per 
i file su disco), la Specifica OCL FILE (per i file su minidisco) e la Specifica 
OCL FILE (per i file su nastro). 
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Differenze dai Parametri di Procedura 


Se viene specificato T1, T2 o TC per il parametro UNIT nella specifica FILE, deve 
essere specificato anche RECFM-FB, RECL-256 e BLKL-24576. 


Per la specifica COPYFILE: 


CHAR- caratteri” consente di specificare un massimo di 30 caratteri di dati. | dati 
devono iniziare e terminare con apici (’). inoltre è possibile specificare apici 
nella stringa di caratteri immettendo due apici. Per esempio, l'orologio ver- 
rebbe immesso nella forma ‘l'orologio’. 


CHAR-Xdddd...dd specifica dati esadecimali. E’ possibile specificare fino a 15 
byte, dove 2 cifre (dd) rappresentano il byte esadecimale. Le cifre esadecima- 
li vanno da 0 ade da A a F. La X deve precedere le cifre esadecimali. 


Per la specifica di controllo del programma di utilità SELECT: 


RECORD specifica che deve essere listata una porzione del file. Quando viene 
specificato RECORD, i parametri FROM e TO {se viene usato TO) devono 
specificare i numeri relativi di record. 


FROM-valore iniziale specifica il numero relativo di record del primo record 
da listare. Per esempio, se il primo record da copiare è il quinto nel file, 
occorre specificare FROM-5. Se deve essere copiato o visualizzato un solo 
record, i parametri FROM e TO devono specificare lo stesso numero relativo 
di record. 


TO-valore finale specifica il numero relativo dell'ultimo record da listare. 
Per esempio se l'ultimo record da copiare è il quindicesimo nel file, occorre 
specificare TO-15. Se deve essere copiato o visualizzato un solo record, i pa- 
rametri FROM e TO devono specificare lo stesso numero relativo di record. 
Il parametro TO non può essere specificato a meno che non si sia specificato 
anche il parametro FROM. Se il valore finale non viene specificato, il file viene 
stampato fino all'ultimo record del file. 


KEY o PKY specifica che deve essere copiata una porzione specificata di un file 
a indice. Deve essere specificato PKY se il file a indice contiene chiavi com- 
presse. Se vengono usate chiavi compresse, è possibile specificare un massimo 
di 57 caratteri numerici. Se vengono usate chiavi normali, è possibile specifi- 
care un massimo di 29 caratteri. 


FROM-valore iniziale specifica la chiave (o i caratteri iniziali della chiave) del 
primo record da listare. Il valore iniziale deve essere racchiuso tra apici ('). 
Se nessuna delle chiavi nel file inizia con i caratteri specificati, il record 
con la successiva chiave più elevata è il primo da listare, Per esempio, se vie- 
ne specificato FROM-‘15’, la prima chiave che inizia con 15 o con un nume- 
ro maggiore è quella del primo record da listare. Se deve essere listato un 
solo record, i parametri FROM e TO devono specificare la stessa chiave. 


TO-valore finale specifica la chiave (o i caratteri iniziali della chiave) dell’ul- 
timo record da listare. II valore finale deve essere racchiuso tra apici (’). Se 
nessuna delle chiavi nel file inizia con i caratteri specificati, il record con la 
successiva chiave inferiore è l’ultimo da listare. Per esempio, se viene specifi- 
cato TO-‘34’, l'ultima chiave che inizia con 34 {oppure se non c'è alcuna 
chiave che inizia con 34, l'ultima chiave che inizia con un valore minore di 
34) è la chiave dell'ultimo record da listare. Il parametro TO non può essere 
specificato a meno che non sia specificato anche il parametro FROM. 


Se non è specificato il parametro TO, $COPY usa l'ultima chiave dell'indice 
come chiave TO. Se deve essere listato un solo record, i parametri FROM e 
TO devono specificare la stessa chiave. 


Esempio 1 
Battere soltanto i caratteri stampabili in tutti i record del file denominato FILE1, 


// LOAD $COPY 

// FILE NAME-COPYIN,UNIT-F1,LABEL-FILEl 
// RUN 

// COPYFILE OUTPUT-CHAR 

// END 


Esempio 2 


Stampare soltanto i record da 5 a 10 nel file su disco denominato FILE1. Devo- 
no essere stampati entrambi i caratteri nel record e le rispettive rappresentazioni 
esadecimali. 


/} LOAD $COPY 

// FILE NAME-COPYIN,UNIT-F1,LABEL-FILEl 
// RUN 

// COPYFILE OUTPUT-HEX 

// SELECT RECORDS,FROM-5,T0-10 

// END 


Esempio 3 


Visualizzare tutti i record di un file su nastro denominato. FILE1. Il nastro è 
montato sull'unità 2. 


// LOAD $COPY 

// FILE NAME-COPYIN,UNIT-T2,RECFM-FB,LABEL-FILEl 
// RUN 

// COPYFILE OUTPUT-CRT 

// END 


| Esempio 4 


| Visualizzare il contenuto di un file nastro a cassetta denominato DATAFILE sulla 
unità di lista del sistema. 


/ LOAD $COPY 

// FILE NAME-COPYIN,UNIT-TC,LABEL-DATAFILE 
// RUN 

/l COPYFILE OUTPTX-PRINT 

// END 
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Ripristino di file (Procedura RESTORE) 
Per ulteriori informazioni vedere la Procedura RESTORE. 


| Per ripristinare tutti i file di un insieme precedentemente salvati: 


// LOAD $COPY 
// FILE nn | 


TI 
T2 
// FILE NAME-COPYO,UNIT-F1 
// RUN 
// COPYALL TO-F1 
// END 
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- Per ripristinare un singolo file precedentemente salvato: 


// LOAD $COPY 
// FILE NAME-COPYIN,UNIT-{I1|,LABEL-nome file 
TI 
T2 
// FILE NAME-COPYO,UNIT-F1,LABEL-nome file 
// RUN 
// COPYFILE | OUTPUT-|SAME s | INCLUDE |-{ EQ |-FostrION-posizione | 
SEQUENTL OMIT NE 
(S) 
INDEXED 
(1) 
DIRECT 
(D) 


sCHAR-f'caratteri'! ,REORG-} NO } |rRci-1unghezza resorà | 
Xdddd...da YES 


Î sbIMIT-record massimo | 


// SELECT RECORD),FROM-valore iniziale [T0-valore finale) 
KEY 
PKY 


|// KEY POSITION-posizione chiave, LENGTH-lunghezza chiave | 


// END 








Sono indicati soltanto alcuni parametri per la specifica FILE. Per ulteriori infor- 
mazioni sulla specifica OCL FILE, vedere la Specifica OCL FILE (per i file su 
disco}, la Specifica OCL FILE (per i file su minidisco) e la Specifica OCL FILE 
{per i file su nastro). 
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Differenze dai parametri di procedura 


Se viene T1, T2 o TC come parametro UNIT nella specifica FILE, devono essere 
specificati anche RECFM-FB, RECL-256 e BLKL-24576. 


Se viene specificato T1, T2 o TC, nessun parametro può essere specificato nella 
specifica COPYFILE. Sono inoltre valide le specifiche SELECT e KEY. 


Per la specifica GOPYFILE: 


CHAR-' caratteri’. specifica un massimo di 30 caratteri. | dati devono iniziare e 
terminare con apici (’). E’ possibile inoltre specificare apici nella stringa di 
caratteri immettendo due apici. Per esempio, l'orologio verrebbe immesso 
nella forma ‘l’’orologio’. 


CHAR-Xdddd...dd specifica dati esadecimali. E' possibile specificare fino a 15 
byte, dove 2 cifre (dd) rappresentano il byte esadecimale. Le cifre esadecima- 
li vanno da 0 a 9 e da A a F. La X deve precedere le cifre esadecimali. 


LIMIT-record massimo specifica il numero totale di record da copiare nel file ri- 
pristinato. Può essere immesso qualsiasi numero maggiore di 0. Notare che 
l'SSP non può creare un file che contiene più di 16711408 record. 


La specifica SELECT consente di selezionare ulteriormente quali record copiare. 


RECORD specifica che deve essere elaborata una porzione del file. Quando viene 
specificato RECORD, i parametri FROM e TO {se viene usato TO) devono 
specificare i numeri relativi di record. 


FROM-valore iniziale specifica il numero relativo di record del primo record 
da elaborare. Per esempio, se il primo record da copiare è il quinto nel file, 
occorre specificare FROM-5. Se deve essere copiato o visualizzato un solo 
record, i parametri FROM e TO devono specificare lo stesso numero relativo 


di record. 


TO-valore finale specifica il numero relativo dell'ultimo record da elaborare. 
Per esempio, se l'ultimo record da copiare è il quindicesimo hel file, occorre 
specificare TO-15. Se non è specificato alcun parametro TO, $COPY usa l'ul- 
timo record nel file come record TO. Se deve essere visualizzato o copiato 
un solo record, i parametri FROM e TO devono specificare lo stesso numero 
relativo di record. 


KEY o PKY specifica che deve essere copiata una porzione di un file a indice. 
Occorre specificare PKY se il file a indice contiene chiavi compresse. Se ven- 
gono usate chiavi compresse, è possibile specificare un massimo di 239 cifre. 
Se vengono usate chiavi normali, è possibile specificare un massimo di 120 
caratteri. 


Quando viene usato SELECT KEY o PKY per selezionare record da un file a 
indice, tutti i record le cui chiavi ricadono entro limiti specificati verranno 
copiati sul file di emissione ma i record di emissione saranno in sequenza di 
Chiave soltanto se il file era stato salvato in sequenza di chiave. Per informa- 
zioni sull'ordinamento dei record di un file a indice in sequenza di chiave, 
vedere la Procedura SAVE. 


FROM-valore iniziale specifica la chiave (o i caratteri iniziali della chiave) del 
primo record da elaborare. Il valore iniziale deve essere racchiuso tra apici 
(‘). Se nessuna delle chiavi nel file inizia con i caratteri specificati, il primo 
record da elaborare è quello con la successiva chiave più elevata. Per esem- 
pio, se viene specificato FROM-‘15’, la prima chiave che inizia con 15 o più 
è quella del primo record da elaborare. 


Il valore FROM deve essere minore di o uguale ai valore TO. Se deve essere 
copiato o visualizzato soltanto un record, i parametri FROM e TO devono 
specificare la stessa chiave. 


AT 


TO-valore finale specifica la chiave (o i caratteri di inizio della chiave) del- 
l'ultimo record da elaborare, Il valore iniziale deve essere racchiuso tra apici 
(‘). Se nessuna delle chiavi nel file inizia con i caratteri specificati, il record 
con la successiva chiave inferiore è l'ultimo da elaborare. Per esempio, se vie- 
ne specificato TO-‘34’ l'ultima chiave che inizia con 34 (oppure se non ci 
sono chiavi che iniziano con 34, l'ultima chiave che inizia con un valore mi- 
nore di 34) è la chiave dell'ultimo record da elaborare. 


Il valore TO deve essere maggiore di o uguale al valore FROM. Se non è spe- 
cificato il parametro TO, $COPY usa l'ultima chiave nell'indice come chiave 
TO. Se deve essere elaborato un solo record, i parametri FROM e TO devono 
specificare la stessa chiave. 


La specifica KEY consente di indicare la posizione e la lunghezza della chia- 
ve per i file a indici. Se viene immessa la posizione di chiave o la lunghezza 
della chiave, deve essere immessa anche l’altra. 


POSITION-posizione chiave specifica la posizione iniziale della chiave per il 
file ripristinato. La posizione della chiave deve essere indicata se il file ripri- 
stinato deve essere un file a indice ma il file salvato non era organizzato 
come tale. La posizione della chiave può essere qualsiasi numero da 1 a 4096. 
Se non è specificato un valore, si presume la posizione di chiave per il file 
a indici che era stato salvato. 


LENGHT-lunghezza chiave specifica la lunghezza della chiave per il file ripri- 
stinato. Deve essere indicata la lunghezza della chiave se il file ripristinato 
deve essere un file a indici ma il file salvato non era organizzato come tale. 
La lunghezza della chiave può essere qualsiasi numero da 1 a 120. Se non è speci- 
ficato un valore, si presume la lunghezza della chiave per il file a indici che è stato 
salvato. 


Esempio 1 


Questo| esempio mostra come ripristinare tutti i file che erano stati salvati su mi- 
nidisco| usando la procedura SAVE ALL. | minidischi sono negli alimentatori 
a caricatore M1 e M2 e l'unità minidisco deve automaticamente avanzare a M2 
dopo l'elaborazione dei minidischi in M1, 


// LOAD $COPY 

// FILE NAME-COPYIN,UNIT-I1,LABEL-#SAVE, LOCATION-M1 
//] FILE NAME-COPYO,UNIT-F1l 

// RUN 

// COPYALL TO-F1 

// END 


Esempio 2 


Questo esempio mostra come ripristinare un file su minidisco denominato FILE1. 
La chiave deve essere modificata dalle posizioni da 1 a 4 alle posizioni da 5 a 24 
e degono essere copiati soltanto quei record che contengono in qualsiasi punto la 
frase NEW. 


// LOAD $COPY 

// FILE NAME-COPYIN,UNIT-Il,LABFL-FILEl,LOCATION-S1,AUTO-NO 
// FILE NAME-COPYO,UNIT-F1,LABEL-FILEl 

// RUN 

// COPYFILE OUTPUT-I,INCLUDE-EQ,CHAR-'NEW! 

// KEY POSITION-5,LENGTH-20 

// END 
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Esempio 3 


Questo esempio mostra come ripristinare tutti i file che erano stati salvati su 
nastro usando la procedura SAVE ALL. ll nastro è posto sull'unità. a nastro 1 e 
deve essere riavvolto dopo che i file sono stati ripristinati. 


// LOAD $COPY 

//. FILE NAME-COPYIN,UNIT-T1,LABEL-#SAVE,RECFM-FB, 
RCL-256,BLKI-24576,FEND-REWIND 

// FILE NAME-COPYO,UNIT-F1 

// RUN 

// COPYALL TO-F1 

// END 


Esempio 4 


Questo esempio mostra come ripristinare su disco un file denominato DATAFILE 
su nastro a cassetta. ll nome del file su disco sarà SAVEDATA. 


/I LOAD $COPY 

/l FILE NAME-COPYIN,UNIT-TC,LABEL-DATAFILE 
/l FILE NAME-COPYO,UNIT-F1,LABEL-SAVEDATA 
/l RUN 

/l COPYFILE 

// END 


Ripristino dell’Indirizzario di Risorse di Rete {Procedura RESTNRD) 


li programma di utilità $COPY permette di ripristinare l’indirizzario di risorse di rete da mi- 
nidisco o da nastro a disco. Vedere il programma di utilità $SINCT per informazioni su 
come ripristinare l’indirizzario di risorse di rete come un file di sistema. 


Vedere la procedura RESTNRD per ulteriori informazioni. 


MEMBER USER]-#SI#M1,USER2-#SI#M2 
LOAD $COPY 
FILE NAME-COPYIN,UNIT-(I1 

TI 

T2 


FILE NAME-COPYO, LABEL-#NRD.FLE,UNIT-F1,RETAIN-J 
RUN 

COPYFILE OUTPUT-SAME,SYSFILE-NRD 

END 





$9020488-0 


Solo alcuni dei parametri sono mostrati per la specifica OCL FILE. Per ulteriori informa- 
zioni circa la specifica FILE OCL, vedere la descrizione sotto «Specifica OCL FILE» per i 
file su minidisco e su nastro. 
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Salvataggio di file (Procedura SAVE) 
Per ulteriori informazioni vedere la Procedura SAVE. 


\ Per salvare un file su minidisco, su nastro o su nastro a cassetta. 


// LOAD $COPY 
/] FILE NAME-COPYIN,UNIT-F1,LABEL-nome file 
//] FILE NAME-COPYO,UNIT-(Il),LABEL-nome file 


TI 
T2 
// RUN. 
// COPYFILE |OUTPUT-{ SAME [ro (1 } ,{ INCLUDE|-{ EQ 
SEQUENTL YES OMIT NE 
(S) LT 
INDEXED LE 
(I) GT 
DIRECT GE 
(D) 


> POSITION-posizione 





,CHAR-J'caratteri Ù 
Xdddd...dd 


|REcL-1unghezza record] ||11rr-1imite record | i NO | 
YES 


// SELECT {RECORD|,FRoM-valore iniziale |,ro-valore finale | 
KEY i 
PKY 


[// KEY POSITION-posizione chiave ,LENGTH-lunghezza chiave | 


// END 
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Per salvare tutti i file, gruppi di file o tutti i file salvo i gruppi di file su minidisco, 
| SU nastro 0 su nastro a cassetta. 


LOAD $COPY 

FILE NAME-COPYIN,UNIT-F1 

FILE NAME-COPYO,UNIT-{Il 
TI 
T2 


RUN 


Ti gruppo file YES 


COPYALL TO-(11 sol } , COMPRESS-) NO 
TO 





Per aggiungere un file su disco ad un file su minidisco esistente: 


LOAD $COPY 
ILE NAME-COPYIN,UNIT-F1,LABEL-nome file 
ILE NAME-COPYO,UNIT-Il,LABEL-nome file,PACK-id volume 











Per la specifica OCL FILE sono indicati soltanto alcuni dei parametri. Per ulte- 
riori informazioni sulle specifiche OCL FILE, vedere la Specifica OCL FILE (per 
i file su disco), la Specifica OCL FILE (per i file su minidisco) e la Specifica 
OCL FILE (per i file su nastro). 
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Differenze dai parametri di procedura 


Se viene indicato T1, T2 o TC per il parametro UNIT nella specifica FILE, devono 
essere indicati anche RECFM-FB, RECL-256 e BLKL-24576. 


Se viene specificato T1, T2 o TC, nessun parametro può essere specificato nella 
libreria COPYFILE. Sono inoltre valide le specifiche SELECT e KEY. 


Per la specifica COPYFILE: 


OUTPUT-SAME indica che il file ripristinato deve avere la stessa organizzazione 
di quello che è stato salvato. Se un parametro non viene indicato, si presume 
SAME. 


OUTPUT-SEQUENTL indica che il file ripristinato deve essere organizzato come 
file sequenziale. 


OUTPUT-INDEXED indica che il file ripristinato deve essere organizzato come 
un file a indici. 


OUTPUT-DIRECT indica che il file ripristinato deve essere organizzato come un 
file diretto. 


CHAR- caratteri” specifica un massimo di 30 caratteri. | dati devono iniziare e 
terminare con apice (’). E’ possibile inoltre specificare apici nella stringa di 
caratteri immettendo due apici. Per esempio, l'orologio verrebbe immesso 
nella forma: ‘l’’orologio’. 


CHAR-Xdddd...dd specifica i caratteri di confronto in forma esadecimale. E' 
possibile specificare fino a 15 byte, dove 2 cifre (dd) rappresentano il byte 
esadecimale. Le cifre esadecimali vanno da 0 a 9 e da A a F. La X deve 
precedere le cifre esadecimali. 


RECL specifica la lunghezza di record del nuovo file e può essere qualsiasi nume- 
ro da 1 a 4096. Se questo parametro non viene immesso, viene usata la lun- 
ghezza di record del file da salvare. 


Se la lunghezza di record del file che viene salvato è minore di quella del re- 
cord immesso, le posizioni di record addizionali nel file salvato sono riempite 
con spazi in bianco. Se la lunghezza di record del file che viene salvato è 
maggiore di quella del record immesso, le posizioni in più vengono troncate. 
Se il nuovo file è del tipo a indici ed il campo chiave viene troncato, viene 
visualizzato un messaggio di errore. 


LIMIT indica il numero totale di record da copiare nel nuovo file. E’ possibile 
immettere qualsiasi numero maggiore di 0. Notare che l'SSP non può creare 
un file che contiene più di 16777200 record, 


La specifica di controllo programma di utilità SELECT consente di selezionare 
ulteriormente quali record elaborare. : 


RECORD specifica che deve essere salvata una porzione del file. Quando viene 
specificato RECORD, i parametri FROM e TO (se viene usato TO) devono 
specificare i numeri relativi di record. 


FROM-valore iniziale specifica il numero relativo di record del primo record 
da salvare. Per esempio, se il primo record da salvare è il quinto nel file, 
occorre specificare FROM-5. Se deve essere salvato soltanto un record, i 
parametri FROM e TO devono specificare lo stesso numero relativo di 
record. 
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TO-ultimo record specifica il numero relativo dell'ultimo record da salvare. 
Per esempio, se l’ultimo record da salvare è il quindicesimo del file, occorre 
specificare TO-15. Se deve essere salvato solo un record, i parametri FROM 
e TO devono specificare lo stesso numero relativo di record. Se non è specifi- 
cato il parametro TO, $COPY utilizza l’ultimo record del file come TO-ultimo 
record. 


KEY o PKY specifica che deve essere salvata una porzione specificata di un file a 


indice. Occorre specificare PKY se il file a indici contiene chiavi compresse. 
Se vengono usate chiavi compresse, è possibile specificare un massimo di 239 
caratteri numerici. Se vengono usate chiavi normali, è possibile specificare un 
massimo di 120 caratteri. 


FROM-valore iniziale specifica la chiave (o i caratteri iniziali della chiave) del 
primo record da salvare. ll valore iniziale deve essere racchiuso tra apici (’). 
Se nessuna delle chiavi nel file inizia con i caratteri specificati, il record con 
la successiva chiave più elevata è il primo da salvare. Per esempio, se viene 
specificato FROM-‘15’, la prima chiave che inizia con 15 o più è quella del 
primo record da salvare. 


Il valore FROM deve essere minore di o uguale al valore TO. Se deve essere 
salvato soltanto un record, i parametri FROM e TO devono specificare la 
stessa chiave. 


TO-valore finale specifica la chiave (o i caratteri di inizio della chiave dell’ul- 
timo record da salvare. Il valore finale deve essere racchiuso tra apici (’). Se 
nessuna delle chiavi nel file inizia con i caratteri specificati, il record con la 
successiva chiave inferiore è l'ultimo da salvare. Per esempio, se viene speci- 
ficato TO-'34' l’ultima chiave che inizia con 34 (oppure se non ci sono chiavi 
che iniziano con 34, l’ultima chiave che inizia con un valore minimo di 34) è 
la chiave dell'ultimo record da salvare. 


ll valore TO deve essere maggiore di o uguale al valore FROM. Se deve essere 
salvato solo un record, i parametri FROM e TO devono indicare la stessa 
chiave. Se non è specificato il parametro TO, $COPY usa l’ultima chiave 
nell'indice come chiave TO. 


La specifica KEY consente di indicare la posizione e la lunghezza della chia- 
ve per i file a indici recentemente creati. Se viene immessa o la posizione del- 
la chiave o la lunghezza della chiave, deve essere immessa anche l’altra. 


POSITION-posizione chiave specifica la posizione iniziale della chiave per il 
file salvato. La posizione di chiave può essere qualsiasi numero da 1 a 4096. 
Se non è specificato un valore, si presume la posizione di chiave corrente per 
il file a indici. 


LENGHT-lunghezza chiave specifica la lunghezza della chiave per il file salva- 
to. La lunghezza della chiave può essere qualsiasi numero da 1 a 120. Se non 
è specificato un valore, si presume la lunghezza di chiave corrente per il file 
a indici. 


Per la specifica COPYALL: 


GROUP specifica se devono essere salvati i membri di un gruppo di file. Se non 


è specificato alcun parametro GROUP, vengono salvati soltanto i file che non 
sono membri di un gruppo di file. 


ALL specifica che devono essere salvati tutti ì file e tutti i membri di gruppi 
di file. 


nome gruppo specifica che devono essere salvati tutti i membri del gruppo di 
file specificato. | file che non fanno parte del gruppo di file non sono salvati. 


Per la specifica COPYADD: 


COPYADD specifica che ad un file su minidisco esistente deve essere aggiunto un 
file, 


Esempio 1 


Questo esempio mostra come salvare su minidisco tutti i file su disco per un pe- 
riodo di 7 giorni. |! minidischi hanno un ID di volume di VOL001 e sono posti 
nei caricatori M1 e M2, iniziando dalla posizione M1.01. 


// LOAD $COPY 
// FILE NAME-COPYIN,UNIT-F1 
// FILE NAME-COPYO,UNIT-Il,LABEL-#SAVE,PACK-VOLOO1,RETAIN-7, 





"0; LOCATION-M1.01 
// RUN 
// COPYALL TO-I1l,GROUP-ALL 
// END 

Esempio 2 


Salvare un file denominato FILE1 ed aggiungerlo ad un file su minidisco esistente 
denominato FILE2. L'ID di volume dei minidisco è VOL001. 


// LOAD $COPY 

// FILE NAME-COPYIN,UNIT-F1,LABEL-FILEl 

// FILE NAME-COPYO,UNIT-I1,LABEL-FILE2,PACK-VOLOO1 
// RUN 

// COPYADD 

/ / END 


Esempio 3 


Salvare un minidisco tutti i file pertinenti al gruppo di file A1. Il nome da asso- 
ciare con la serie di file salvati è SAVEA1. L’ID di volume del minidisco è 
VOL002, ed il file sarà salvato per 39 giorni. 


// LOAD $COPY 

// FILE NAME-COPYIN,UNIT-F1 

si FILE NAME-COPYO,UNIT-I1l,LABFI-SAVEA1,PACK-VOLOO2,RETAIN-39 
RUN 

// COPYALL TO-I1,GROUP-A1 

// END 
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Esempio 4 


Questo 


esempio mostra come salvare su minidisco specifici record da un singolo 


file denominato FILE3, | soli record da salvare contengono la parola SAVE nelle 
posizioni da 10 a 13 del record. 


Esempio 5 


Questo 


LOAD $COPY 

FILE NAME-COPYIN,UNIT-F1,LABEL-FILE3 

FILE NAME-COPYO,UNIT-I1l,LABEL-FILE3,PACK-VOLOO1l 
RUN 

COPYFILE INCLUDE-EQ,POSITION-10,CHAR-' SAVE! 

END 


esempio mostra come salvare su minidisco soltanto i record da 5 a 10 di 


un file su disco denominato FILE4. L’ID di volume del minidisco è VOL001. 


Esempio 6 


Questo 
FILEA, 


LOAD $COPY 

FILE NAME-COPYIN,UNIT-F1,LABEL-FILEÙ 

FILE NAME-COPYO,UNIT-I1l,LABEL-FILEÙ,PACK-VOLOOl 
RUN 

COPYFILE 

SELECT RECORD,FROM-5,T0-10 

END 


esempio mostra come salvare su nastro un file su disco denominato 
L'ID di volume del nastro è VOL001 e deve essere salvato sull'unità 


nastro 2. Dopo il salvataggio, la posizione del nastro deve essere lasciata al termi- 
ne del file. 


//l LOAD $COPY 
// FILE NAME-COPYIN,LABEL-FILE4, UNIT-F1 
// FILE NAME-COPYO,LABEL-FILE4, UNIT-T2,RECFM-FB 


RECL-256,BLKL-24576, VOLID-VOL001,END-LEAVE 


/l RUN 
// COPYFILE 
// END 


LES 


| Esempio 7 


Questo esempio mostra come salvare un file disco denominato DATAFILE su un 
nastro a cassetta. Il nome sul nastro era stato modificato in SAVEDATA. 


/{ LOAD $COPY 

// FILE NAME-COPYIN, UNIT-F1,1.ABEL-DATAFILE 

// FILE NAME-COPYO, UNIT-TC,LABEL-SAVEDATA,RECL-256, 
Il BLKL-24576,RECFM-FB, VOLID-TESTI] 

/l RUN 

/l COPYFILE 

// END 


Salvataggio dell’Indirizzario di Risorse di Rete (Procedura SAVENRD) 


Il programma di utilità $COPY permette di salvare l’indirizzario di risorse di rete su minidi- 
sco 0 su nastro. 


Vedere la procedura SAVENRD per ulteriori informazioni. 


// MEMBER USER1-#SI#M1,USER2-#SI#M2 
// LOAD $COPY 
// FILE NAME-COPYIN,UNIT-F1,LABEL-#NRD.FLE 
// FILE NAME-COPYO,UNIT-{I1 
T1 
T2 


// RUN 
// COPYFILE OUTPUT-SAME,SYSFILE-NRD 
// END 





Per la specifica OCL FILE sono indicati soltanto alcuni parametri. Per ulteriori informazio- 
ni sulla specifica OCL FILE, vedere ia «Specifica OCL FILE» (per i file su minidisco) e la 
«Specifica OCL FILE» (per i file su nastro). 
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Specifiche compatibili con IBM Sistema/34 


Per la copia di file, queste specifiche sono supportate per motivi di compatibilità 
con il Sistema/34 IBM. 


Per copiare un file: 


LOAD $COPY 
FILE NAME-COPYIN,LABEL-nome file di immissione sei 
Il 


FILE NAME-COPYO,LABEL-nome file di ei 
Il 


RUN 


'posizione,cc! YES 
‘posizione , Xdd' 
'posizione,Xdddd' 

SYSDEL 


COPYFILE OUTPUT-DISK|,DELETE-('posizione,c' sRRORG- (ao. } 


SELECT { RECORD |,FROM-valore iniziale [,T0-valore Finale 
KEY — 
PKY 


KEY POSITION-posizione chiave,LENGTH-lunghezza cniave | 


END 
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Per listare un file: 


// LOAD $COPY 
// FILE NAME-COPYIN,LABEL-nome file di immissione I 
Il 


// RUN 


// COPYFILE {OUTPUT-PRINT | | ,DELETE-('posizione,c' ,REORG-{ 10 } 
OUTPTX-PRINT 'posizione,cc' YES 
‘posizione ,Xdd'! 
‘posizione ,Xdadd' 
SYSDEL 


// SELECT | RECORD|,FROM-valore iniziale |-To-vazore finale | 
KEY 
PKY 


// END 





Per la specifica OCL FILE sono presentati soltanto alcuni dei parametri. Per in- 
formazioni sulla specifica OCL FILE, vedere la Specifica OCL FILE (per i file su 
minidisco) e la Specifica OCL FILE (per i file su disco). 


Per la specifica COPYFILE: 


OUTPUT-DISK specifica che l'emissione deve essere scritta su disco o su minidi- 
sco. Le specifiche OCL COPYO FILE e COPYIN indicano il file da copiare 
(COPYIN) ed il nuovo file (COPYO). 


OUTPUT-PRINT o OUTPUTX-PRINT specifica che un file deve essere listato to- 
talmente o parzialmente sull'unità di lista di sistema per il terminale video. 
Questo parametro è supportato per compatibilità con il Sistema/34 IBM. 


DELETE indica i record che devono essere cancellati. ll parametro DELETE è 
facoltativo ed è supportato per compatibilità con il Sistema/34 IBM. 


‘posizione,c’ indica che deve essere cancellato qualsiasi record che contiene il 
carattere specificato nella posizione indicata. Per esempio, DELETE-'‘50,S' 
cancella tutti i record che hanno una S nella posizione 50. 


‘posizione,cc’ indica che deve essere cancellato qualsiasi record che contiene i 
due caratteri indicati nella posizione iniziale specificata. Per esempio, DELE- 
TE-'50,ST' cancella tutti i record che hanno ST nelle posizioni 50 e 51. 


‘posizione, Xdd' indica che deve essere cancellato qualsiasi record che ha il 
carattere indicato nella posizione specificata. Xdd è il valore esadecimale del 
carattere. Per esempio, DELETE-'50,X31' cancella tutti i record che hanno 
l'esadecimale 31 nella posizione 50. 
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‘posizione Xdddd" indica che deve essere cancellato qualsiasi record che ha i 
due caratteri specificati nella posizione iniziale indicata. Xdddd è il valore 
esadecimale dei due caratteri. Per esempio, DELETE-‘50,X3132' cancella tut- 
ti i record che hanno i valori esadecimali 3132 nelle posizioni 50 e 51. 


SYSDEL specifica che qualsiasi record cancellato dal sistema deve essere can- 
cellato dal file. 


REORG-YES specifica che: 


e Per un file a indici, i record vengono copiati sequenzialmente per chiave. 
Inoltre, i record cancellati devono essere cancellati o non listati, 


e Peri file sequenziali, i record cancellati dal sistema devono essere cancel- 
lati. 


REORG-NO specifica che i record vengono copiati nell'ordine in cui compaiono 
nel file. Se non viene specificato alcun parametro REORG, si presume 
REORG-NO. 


La specifica di controllo programma di utilità SELECT consente di selezionare 
quali sono i record da elaborare. 


RECORD specifica che deve essere copiata una porzione del file. Quando viene 
specificato RECORD, i parametri FROM e TO (se viene usato TO) devono 
specificare i numeri relativi di record. 


FROM-valore iniziale specifica il numero relativo di record del primo record 
da copiare. Per esempio, se il primo record da copiare è il quinto nel file, 
occorre specificare FROM-5. Se deve essere copiato un solo record, i parame- 


tri FROM e TO devono specificare lo stesso numero relativo di record. 


TO-ultimo record specifica il numero relativo dell'ultimo record da copiare. 
Per esempio, se l'ultimo record da copiare è il quindicesimo nel file, occorre 
specificare TO-15. Se deve essere copiato un solo record, i parametri FROM 
e TO devono specificare lo stesso numero relativo di record. Se non è specifi- 
cato il parametro TO, $COPY utilizza l’ultimo record del file come TO-ultimo 
record. 


KEY o PKY indica che deve essere copiata una porzione specificata di un file a indici. 
Deve essere indicato PKY se il file a indici contiene chiavi compresse. Se vengono 
usate chiavi compresse, è possibile specificare un massimo di 239 caratteri numeri- 
ci. Se vengono usate chiavi normali, è possibile specificare un massimo di 120 ca- 
ratteri. 


FROM-valore iniziale specifica la chiave (o i caratteri iniziali della chiave) del 
primo record da copiare. Il valore iniziale deve essere racchiuso tra apici (‘). 
Se nessuna delle chiavi nel file inizia con i caratteri specificati, il record con 
la successiva chiave più elevata è il primo da salvare. Per esempio, se viene 
specificato FROM-‘15’, la prima chiave che inizia con 15 o più è quella del 
primo record da salvare. i 


Il valore FROM deve essere minore di o uguale al valore TO. Se deve essere 
salvato soltanto un record, i parametri FROM e TO devono specificare la 
stessa chiave. Ì 
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TO-valore finale specifica la chiave o i caratteri di inizio della chiave dell'ultimo record 
da salvare. Il valore finale deve essere racchiuso tra apici (’). Se vengono usate chia- 
vi compresse, è possibile specificare un massimo di 239 caratteri numerici. Se nes- 
suna delle chiavi nel file inizia con i caratteri specificati, il record con la successiva 
chiave inferiore è l’ultimo da salvare. Per esempio, se viene specificato TO-'34", l’ul- 
tima chiave che inizia con 34 (oppure se non ci sono chiavi che iniziano con 34, l’ul- 
tima chiave che inizia con un valore minore di 34) è la chiave dell'ultimo record da 
copiare. 


Il valore TO deve essere maggiore dei valore FROM o uguale ad esso. Se deve 


essere copiato un solo record, i parametri FROM e TO devono specificare la 
stessa chiave. Se non è specificato il parametro TO, $COPY usa l’ultima 
chiave nell'indice come chiave TO. 


La specifica KEY consente di indicare la posizione e la lunghezza della chia- 
ve per i file a indici. Se viene immessa o la posizione di chiave o la lunghezza 
della chiave, deve essere immessa anche l’altro elemento. 


POSITION-posizione chiave specifica la posizione iniziale della chiave per il 
nuovo file. La posizione di chiave deve essere specificata se il nuovo file deve 
essere a indice ma il vecchio file non era organizzato come tale. La posizione 
di chiave può essere qualsiasi numero da 1 a 4096. Se non è specificato un 
valore, si presume la posizione di chiave del vecchio file a indice. 


LENGTH-lunghezza chiave specifica la lunghezza della chiave per il nuovo file. Deve 
essere specificata la lunghezza della chiave se il nuovo file deve essere un file a indi- 
cè ma il vecchio file non era organizzato come tale. La lunghezza della chiave può 
essere qualsiasi numero da 1 a 120. Se non è specificato un valore, si presume la 
lunghezza di chiave del vecchio file a indice. 


Esempio 1 


Per salvare su minidisco un file su disco denominato FILEA: 


// LOAD $COPY 

// FILE NAME-COPYIN,LABEL-FILEA,UNIT-F1 

// FILE NAME-COPYO,LABEL-FILEA,PACK,VOLOO1 
// RUN 

// COPYFILE OUTPUT-DISK 

// END 


Esempio 2 


Per listare un file su disco denominato FILEA. 


// LOAD $COPY 

// FILE NAME-COPYIN,LABEL-FILEA,UNIT-F1 
// RUN 

// COPYFILE OUTPUT-PRINT 

// END 


PROGRAMMA DI UTILITA’ $CPPE 


Il programma di utilità $CPPE consente di visualizzare un messaggio di errore 
= specificato (procedura ERR). 


Per ulteriori informazioni, vedere la Procedura ERA. 


// LOAD $CPPE 
// RUN 


// ERR MIC-codice id messaggio ,CONTROL-opzione ,ALPHA-USER 
// END 





Differenze dai parametri di procedura 


ALPHA-USER specifica che deve essere usato il membro messaggio utente cor- 
rente livello 1 per richiamare il messaggio. 


Esempio 


Questo esempio mostra il programma di utilità $CPPE che visualizza un messag- 
gio con il numero MIC 0014. Le opzioni ammesse sono 0, 1 e 3. 


// LOAD $CPPE 

// RUN 

// ERR MIC-001},CONTROL-013,ALPHA-USER 
// END 


PROGRAMMA DI UTILITA’ $CZUT 


Il programma di utilità $CZUT permette di specificare quali messaggi di sistema do- 
vrebbero essere considerati come messaggi di avviso. 


Vedere la Procedura ALERT per ulteriori informazioni. 


// MEMBER PROGRAMI-#CZ#AU1 
// LOAD $CZUT 


// RUN 
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| PROGRAMMA DI UTILITÀ $DCOPY 


| Il programma di utilità $DCOPY consente di avere quante copie si vogliono del sin- 
golo minidisco diagnostico (microprogramma). 


| Per maggiori informazioni vedere la procedura COPYDIAG. 


// LOAD $DCOPY 


// RUN 





| Esempio 
Ì Per copiare un minidisco diagnostico: 


/l LOAD $DCOPY 
// RUN 


PROGRAMMA DI UTILITA’ $DDST 


Il programma di utilità $DDST consente di ordinare le chiavi indici per un file su 
disco. 


Per ulteriori informazioni vedere la Procedura KEYSORT. 





// LOAD $DDST 
// RUN 





ggmmaa TP 


// KEYSORT LABEL-nome file |,DATE- ‘mnggaa aa } 
aammgg 


,SHRCKDUP-{N0 
YES 


Esempio 


Ordinare le chiavi di indice in un file residente (T) denominato PAYRCD. 


// LOAD $DDST 

// RUN 

// KEYSORT LABEL-PAYRCD,RETAIN-T 
// END 


PROGRAMMA DI UTILITA’ $DELET 


ll programma di utilità $DELET consente di rimuovere file, librerie o cartelle dal disco o 
. dal minidisco. 


Per ulteriori informazioni vedere la Procedura DELETE. 


Per cancellare uno o più file da minidisco: 


// LOAD $DELET 
// RUN 


vd 4 e) Sd, ae sDATE-{ mnggaa sLOCATION-|S1 


REMOVE ALL ggmmaa 2 
aammgg 93 
Ml.nn 


M2.nn 


|,PacK-ia volume | »DATA-f NO 
YES 





Per cancellare un file, una libreria, una cartella o un gruppo di file da disco: 


// LOAD $DELET 
// RUN 


// {SCRATCH| LABEL-| nome file SsUNIT-F1|,DATE-fmmggaa ,USERLIBS-fNO 
REMOVE nome libreria ggmmaa YES 


ALL aammgg 


,GROUP-f gruppo tile] “para-f no. 
ALL YES 





Le specifiche di controllo programma di utilità SCRATCH e REMOVE possono essere ri- 
petute per cancellare parecchi file, librerie o cartelle con un solo caricamento ed una sola 
esecuzione nel programma di utilità $DELET. 
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Differenze dai parametri di procedura 


DATA specifica se i dati nel file, libreria, o cartella devono essere cancellati. Il parametro 
DATA è ammesso soltanto se viene usata la specifica di controllo programma di uti- 
lità REMOVE. DATA-YES esegue la stessa funzione del parametro ERASE nella 
procedura DELETE. 


USERLIBS specifica se devono essere cancellate una o più librerie. YES specifica 

che devono essere cancellate le librerie. Se è specificato FOLDER-YES o LABEL- 

| ALL vengono cancellati anche i file. NO indica che le librerie non devono esse- 
re cancellate. 


FOLDERS specifica se una o più cartelle devono essere cancellate. YES specifica 
| che le cartelle devono essere cancellate. Se è specificato FOLDER-YES o LABEL- 
ALL vengono cancellati anche i file. NO specifica che le cartelle non devono 

essere cancellate. 


GROUP-ALL indica che devono essere cancellati tutti i file sul disco se era stato 

specificato UNIT-F1 e LABEL-ALL. Se sono specificati LABEL-ALL, UNIT-F1, 
USERLIBS-YES, FOLDER-YES e GROUP-ALL vengono cancellati tutti i file, li- 
brerie e cartelle su disco. Se vengono specificati LABEL-ALL e UNIT-F1 ma non 
GROUP-ALL, devono essere cancellati tutti i file che non fanno parte di un gruppo 
di file. 
Se è attiva la riservatezza mediante parola d'ordine, ALL può essere specifi- 
cato soltanto da un operatore che ha una classificazione di sicurezza di ope- 
ratore di sistema o più elevata. Se non è attiva la riservatezza mediante paro- 
la d'ordine, ALL può essere specificato solo dalla console di sistema. 


Esempio 1 


Per cancellare il file denominato PAYROLL dal minidisco nell’alimentatore S1: 


// LOAD $DELET 

// RUN 

// REMOVE LABEL-PAYROLL,UNIT-Il 
// END 


Esempio 2 


Per cancellare tre file e due librerie con un solo caricamento e una sola esecuzio- 
ne del programma di utilità $DELET: 


// LOAD $DELET 

// RUN 

// REMOVE LABEL-FILE1,UNIT-F1 

// REMOVE LABEL-FILE2,UNIT-F1 

// REMOVE LABEL-FILE3,UNIT-F1 

// REMOVE LABEL-LIBRARY1,UNIT-F1,USERLIBS-YES 
// REMOVE LABEL-LIBRARY2,UNIT-F2,USERLIBS-YES 
// END 


Esempio 3 


Per cancellare dal disco tutti i file e le librerie: 


/{ LOAD $DELET 
/{{ RUN 
| /l REMOVE LABEL-ALL, UNIT-F1,USERLIBS-YES,FOLDER-YES, 
GROUP-ALL 
// END 


Le librerie e i file di sistema non verranno cancellati; verranno però cancellate le li- 
brerie dei prodotti programma. 
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PROGRAMMA DI UTILITA’ $DUPRD 


Il programma di utilità $DUPRD consente di copiare file o librerie su minidisco o 
minidischi su un altro minidisco o su altri minidischi. 


Per ulteriori informazioni vedere la Procedura COPY/1. 


// LOAD $DUPRD 

// FILE NAME-COPYIl,UNIT-I1}|,DATE-(mmggaa 
ggmmaa 
aammgg 


// RUN 


// COPYIl NAME-fALL sPACK-id volume | ,DELETE-JNO s PRESERVE-f NO 
nome file YES YES 


,COPIES-fcopie sLOCATION-{S1l 
Ì MIO 
tal: M1.01 





Esempio 1 


Copiare un file su minidisco denominato PAYROLL su un minidisco con un ID 
di volume di VOLO01: 


// LOAD $DUPRD 

// FILE NAME-COPYIl,UNIT-Il 

// RUN 

// COPYI1l NAME-PAYROLL,PACK-VOLOO1,LOCATION-S1 
// END 
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PROGRAMMA DI UTILITA’ $FBLD 
Il programma di utilità $FBLD consente di: 
e Creare un nuovo file vuoto su disco (Procedura BLDFILE). 


e Creare un indice alternativo per un file fisico (procedura BLDINDEX). 


Creazione di file (Procedura BLDFILE) 


Per ulteriori informazioni vedere la Procedura BLDFILE. 


// LOAD $FBID 

// RUN 

// FILE LABEL-nome file sATTRIB-ISEQUENTLI, BLOCKS-ampiezza sRECL- lunghezza, 
(S) B-ampiezza record 
INDEXED RECORDS-ampiezza 
(I) R-ampiezza 
DIRECT 
(D) 


s LOCATION- Al sRETAIN-IT sDFILE-JNO 
A2 YES 
numero blocco 


|FOBIT1ON-pos zione chiave, LENGTH-lunghezza chiave | 


sDUPKEY-f NO sEXTEND-fvalore estensione 
YES o 





La specifica di controllo programma di utilità FILE può essere ripetuta per co- 


struire parecchi file con un solo caricamento ed esecuzione del programma di 
utilità $FBLD. 
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Esempio 


Creare un file residente suscettibile di cancellazione lungo 13 blocchi. il file è 
INVOICE, la lunghezza record è 50 byte, la posizione preferita nel file è sul 
primo disco e ciascun record contiene una chiave di 4 byte che inizia alla posizio- 
ne 9 nel record. 


/] LOAD $FEID 


// RUN 

// FILE LABEL-INVOICE,ATTRIB-I,BLOCKS-13,RECL-50 
li LOCATION-A1 ,RETAIN-T,DFILE-YES, 

// POSITION-9, LENGTH-l 

// END 


Creazione di indici alternativi (Procedura BLDINDEX) 


Per ulteriori informazioni vedere la Procedura BLDINDEX. 
















// LOAD $FBID 

// RUN 

// FILE LABEL-nome file indice SERRA NHL 
Xx 


POSITION-posizione chiave ,LENGTH-lunghezza chiave ,PLABEL-nome file ad 
indici, 


> 


sPDATE-fmmggaa 3DUPKEY- j YES sLOCATION-| Al 
egmmaa NO 2 


aammgg si 
A 


numero blocco 





Esempio 


Questo esempio mostra come creare un file ad indici alternativi da un file ad in- 
dici denominato CUSTOMER. Il file CUSTOMER è disposto per chiavi su un nu- 
mero di cliente nelle posizioni da 1 a 4 del record. ll file di indice alternativo 
deve essere ordinato per chiavi di nomi di clienti, nelle posizioni da 5 a 20 del 
record (una lunghezza chiave di 16), deve essere denominato CUSTNAME e deve 
avere una locazione preferita A2. 


// LOAD $FBLD 


// RUN 

// FILE LABEL-CUSTNAME,ATTRIB-ALTINDEX,PLABEL-CUSTOMER, 
I} POSITION-5, LENGTH-16 ,DUPKEY-YES,LOCATION-A2 

// END 
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PROGRAMMA DI UTILITA’ $FREE 


Il programma di utilità $FREE consente di riunire lo spazio libero su un disco 
nell'ambito dell’area dell'utente. : 


Per ulteriori informazioni vedere la Procedura COMPRESS. 















// LOAD $FREE 





// RUN 

// COMPRESS | DISK-(ALL | [ere LOW 
AL HIGH 
A? ti 
43 


Ah 


Esempio 


Per comprimere lo spazio libero sul disco: 


// LOAD $FREE 
// RUN 
// END 


PROGRAMMA DI UTILITA’ $HELP 


x 


Per ulteriori informazioni vedere la Procedura HELP, Non è possibile eseguire 
$HELP immettendo le specifiche OCL RUN e LOAD dalla tastiera. 
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PROGRAMMA DI UTILITA’ $HIST 


Il programma di utilità $HIST.consente di visualizzare, stampare, copiare o can- 
cellare entrate nel file cronologico. 


Per ulteriori informazioni vedere la Procedura HISTORY. 


// LOAD $HIST 


// RUN 


// DISPLAY 





CRT » | USER s [ALLWS s |ALLENTS 
LIST ALL id terminale EONLY 

COPYSYS { [id utente nome procedura 
COPYPRT 

ERASE 


È 
ALIDAYS |, [dall'ora |,|all'ora |, [nome file | NOERASE 
TODAY 000000 235959 HF id unità video| | FRASE 


data 














Esemp io 


Per listare le entrate di file cronologico associate all'esecuzione di una procedura 
denominata TEST: 


// LOAD $HIST 
// RUN 
// DISPLAY LIST,,,TEST 
// END 
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PROGRAMMA DI UTILITA’ $IDSET 


ll programma di utilità $IDSET consente di visualizzare, aggiornare o cancellare 
una lista .di ID remoti da usare dal sottosistema BSCEL SSP-ICF su una linea di 


comunicazioni commutata. 


Per ulteriori informazioni vedere la Procedura DEFINEID. 


// LOAD $IDSET 
// RUN 
// DEFINEID MODE-f DISPLAY 


UPDATE 
DELETE 





Esempio 
Per creare o aggiornare la lista 1D remota: 


// LOAD $IDSET 

// RUN 

// DEFINEID MODE-UPDATE 
// END 
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PROGRAMMA DI UTILITA’ $IEDS 


Il programma di utilità $SIEDS consente di disabilitare un sottosistema SSP-ICF, 
MSRJE o un'emulazione di unità 3270. 


Per ulteriori informazioni vedere la Procedura DISABLE. 


// LOAD $IEDS 
// RUN 


// DISABLE SUBSYS-nome configurazione |. 10cAr1ON-n0me locazione | 


// END 


Esempio 
Per disabilitare la configurazione di sottosistema SUB1: 


// LOAD $IEDS 

// RUN 

// DISABLE SUBSYS-SUBI 
// END 
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PROGRAMMA DI UTILITA’ $IENBL 


ll programma di utilità $IENBL consente di abilitare il sottosistema SSP-ICF, 
MSRIJE o l'emulazione di unità 3270. 


Per ulteriori informazioni vedere la Procedura ENABLE. 


// LOAD $IENBL 
// RUN 


// ENABLE SUBSYS-nome configurazione | ,LIBRNAME-f nome libreria 
libreria corrente di sessione 


sLINE-|1 +S1OW-{x0 } | .LocatION-nome Locazione | 
YES a 





Esempio 


Nell'esempio che segue, il programma di utilità $IENBL abilita il sottosistema 
specificato per il membro di configurazione SUB1 trovato nella libreria denomi- 
nata MYLIB. SUB1 deve usare la linea di comunicazione 1 ed i parametri per 
questa configurazione devono essere visualizzati. 


// LOAD $IENBL 
// RUN 
// ENABLE SUBSYS-SUB1l,LIBRNAME-MYLIB,LINE-1,SHOW-YES 


// END 


PROGRAMMA DI UTILITA' $INIT 


Il programma di utilità $INIT consente di inizializzare uno o più minidischi. 
de 


Per ulteriori informazioni vedere la Procedura INIT. 


77 LOAD $INIT 
// RUN 


// UIN OPTION-} RENAME ,LOCATION-{ S1 sENDLOC-{S1 
FORMAT 52 S2 
FORMAT2 53 S3 

DELETE Ml.nn Ml.nn 

| M2.nn M2.nn 


NO 80 


dba a sn ; 


// VOL PACK-ia volume ,ID-id titolare 
// END 





Differenze dai parametri di procedura 


ACTFLMSG specifica se deve essere eseguito un controllo per individuare i file 
attivi. La procedura INIT controlla sempre i file attivi. YES specifica che i 
file attivi devono essere controllati da $INIT. Se sul minidisco ci sono file at- 
tivi, dovrebbe essere visualizzato un messaggio. NO specifica che i file attivi 
non devono essere controllati da SINIT. 


RECL-lunghezza record specifica la lunghezza record da assegnare a ciascun setto- 
re di minidisco. Se non è specificato alcun valore, si presume 80. Questo da- 
to non è usato dal Sistema/36; le informazioni sono inserite nei settori di 
minidisco, indipendentemente dalla lunghezza di record specificata per i 
settori. 


Esempio 


Ridenominare un minidisco in modo che il nuovo ID di volume sia VOL0O01 ed il 
nuovo ID del titolare sia YOURNAME. Il minidisco è nell'alimentatore S1. 


// LOAD $INIT 

// RUN 

// UIN OPTION-RENAME 

// VOL PACK-VOLOO1 ,ID-YOURNAME 
// END 
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PROGRAMMA DI UTILITA’ $LABEL 


Il programma di utilità $LABEL consente di listare su disco, minidisco o nastro i 
nomi dei file e delle librerie. 


Per ulteriori informazioni vedere la Procedura CATALOG. 


// LOAD $LABEL 


// RUN 


// DISPLAY SL rie} [uom {en} , LOCATION-(S1 
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52 
S3 
Ml.nn 
M2.nn 


ALL Il 


,ENDLOC-( S1 sa } ,END- { REWIND 


s2 LOCATION LEAVE 
S3 UNLOAD 
Ml.nn 
M2.nn 





Esempio 


Visualizzare i contenuti di un minidisco nell’alimentatore $1: 


// LOAD $ LABEL 
// RUN 
// DISPLAY LABELCVALL,UNIT-Il 


// END 
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PROGRAMMA DI UTILITA’ $MAINT 


Il programma di utilità $MAINT consente di: 


Creare una libreria su disco (Procedura BLDLIBR) 


Creare membri origine o di procedura 


Cambiare la dimensione di una libreria o del suo indirizzo o modificare la posizione 
di una libreria {Procedura ALOCLIBR) 


Cambiare informazioni relative ad un membro di libreria (Procedura CHNGEMEN) 
Riunire spazio di libreria inutilizzato (Procedura CONDENSE) 


Copiare un membro da una libreria su disco, su minidisco, su nastro o su nastro 
a cassetta (Procedura FROMLIBR) 


Copiare membri da disco, minidisco, nastro o nastro a cassetta su una libreria 
(Procedura TOLIBR) 


Avviare un lavoro da disco, minidisco, nastro o nastro a cassetta (Procedura 
JOBSTR) 


Listare membri ed informazioni dì libreria (Procedura LISTLIBR) 


Listare informazioni relative a librerie su disco, minidisco, nastro o nastro a cas- 
setta (Procedura LISTFILE) 


Rimuovere membri da una libreria (Procedura REMOVE) 


Salvare una libreria su minidisco, su nastro o su nastro a cassetta (Procedura 
SAVELIBR) 


Ripristinare una libreria da minidisco, da nastro o nastro a cassetta su una li- 
breria (Procedura RESTLIBR). 


Sono inoltre illustrate le specifiche di controllo dei programmi di utilità $MAINT 
supportate per compatibilità con il Sistema/34 ed il formato delle specifiche 
COPY e CEND usate dal programma di utilità SMAINT. 
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Creazione di una libreria (Procedura BLDLIBR) 


Per ulteriori informazioni vedere la Procedura BLDLIBR. 


// LOAD $MAINT 


// FILE NAME-nome file ,UNIT-{Il 
Fl 
TI 
T2 


// RUN 
// ALLOCATE LIBRNAME-nome libreria,LIBRSIZE-ampiezza libreria,STATUS-CREATE 


|DIRSIZE-anpiezza indirizzario] sLOCATION-|A1 
AQ 
A3 
AL 
numero blocco 


// COPY CRE libreria,FILE-nome file 
TAPE 


// END 





Per la specifica OCL FILE sono presentati soltanto alcuni parametri. Per ulteriori 
informazioni sulla specifica FILE, vedere la Specifica OCL FILE (per i file su mi- 
nidisco), la Specifica OCL FILE (per i file su disco) o la Specifica OCL FILE 
{per i file su nastro). 
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Differenze dai parametri di procedura 
STATUS-CREATE specifica che viene creata la libreria. 


Se il file contenente i membri da copiare è nel modo a record, ciascun membro nel file 
deve iniziare con una specifica COPY e terminare con una specifica CEND. Per i formati 
delle specifiche COPY e CEND, vedere le Specifiche COPY e CEND. Le specifiche COPY 
e CEND vengono automaticamente inserite nei membri creati da $MAINT. In ogni caso 
occorre inserirle all’inizio ed alla fine dei membri che non sono creati da $MAINT. Non in- 
serire più di una specifica CEND. Se una specifica CEND esiste nel membro, si avrà un 
messaggio di errore. 


Se il file nel modo a record è organizzato come file diretto, occorre inserire una 
specifica END dopo la specifica CEND che termina l’ultimo membro nel file. H 
formato della specifica END è: 


// END 


dove un solo spazio in bianco deve separare // e END. 


Esempio 


Creare una nuova libreria denominata MYLIB. Questa deve avere una dimensione 
di 100 blocchi ed un indirizzario di 20 settori. 


// LOAD $MAINT 


// RUN 

// ALLOCATE STATUS-CREATE,LIBRNAME-MYLIB,LIBRSIZE-100, 
// DIRSIZE-20 

// END 
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Creazione di membri origine o di procedura 


Il programma di utilità $MAINT consente di creare membri origine ‘e di proce- 
dura. 


li modo più semplice per creare membri origine o di procedura consiste nell'usare 
un programma tipo SEU (programma di utilità immissione origine) che consente 
di immettere e modificare membri di procedura e membri origine di libreria. 


Se non si dispone di SEU, è possibile usare il programma di utilità $SMAINT per 
creare membri di procedura o origine immessi dalla tastiera. (Notare che è possi- 
bile creare membri soltanto usando $MAINT; non è possibile cambiare una speci- 
fica in un membro di libreria usando $SMAINT). 


Il formato delle specifiche per creare un membro di procedura o origine è: 


// LOAD $MAINT 

// RUN i i 

// COPY RR E RE alal 
Ss F1 


YES 


I di i ai e) ares| di 


R 120 


-K1ST-{ ces) [REF-nunero | [.88-sottot.iro | 


NO 


specifiche per membro libreria 


/) CEND 
// END 





FROM-READER indica che le informazioni per il programma $MAINT saranno forni- 
te da SYSIN. La specifica OCL potrà essere immessa da tastiera o inclusa in 
una procedura. 


LIBRARY-P indica che le specifiche che vengono immesse devono essere inserite 
in un membro di procedura di libreria, 


LIBRARY-S indica che le specifiche che vengono immesse devono essere inserite 
in un membro origine di libreria. 


NAME-nome membro indica il nome da assegnare al membro di libreria. Un nome 
membro può contenere un massimo di 8 caratteri e deve iniziare con un carat- 
I tere alfabetico (da A a Z, #, $ o @). 1 punti (.) non possono essere utilizzati. 
I rimanenti caratteri possono essere in qualsiasi combinazione (numerici, alf- 
betici o speciali). Occorre evitare di usare i seguenti caratteri in quanto hanno 
significati speciali nelle procedure: virgole (,), apice (’), spazio in bianco, punti 
interrogativi (?), barre (/), segni di maggiore (>) e segni di uguale (=). Non usare 
DIR, LIBRARY o ALL come nomi di membro. 
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TO-nome libreria indica il nome della libreria che deve contenere il membro. 


F1 specifica la libreria di sistema (XLIBRARY). 


RETAIN-P specifica che se nella libreria esiste un membro con lo stesso nome 
membro, deve essere visualizzato un messaggio. L'operatore può quindi facol- 
tativamente sostituire il membro esistente o cancellare il programma 
$MAINT. Se non viene specificato il parametro RETAIN, si presume 
RETAIN.P. 


RETAIN-R specifica che se esiste nella libreria un membro con lo stesso nome 
membro, il membro esistente deve essere sostituito. 


RECL-iunghezza specifica indica la lunghezza delle specifiche in caratteri, per il 
membro di procedura o origine e può essere qualsiasi numero decimale da 
40 a 120. Se non è specificato il parametro RECL, si presume 120. 


MRT-VYES specifica che il membro di procedura è una procedura a terminali ri- 
chiedenti multipli (MRT). Se non è ‘specificato MRT-YES, il membro non è 
una procedura MRT, 


PDATA-YES specifica che i dati (non i parametri) possono essere passati sul co- 
mando di procedura, provocando l’inizio della procedura. | dati iniziano con 
il primo carattere diverso dallo spazio in bianco che segue il nome di proce- 
dura e terminano con l’ultimo carattere diverso dallo spazio in bianco nella 
specifica. | dati vengono passati nella prima operazione di immissione dal 
terminale video richiedente dal primo programma nella procedura. Ogni pro- 
cedura MRT ha questo attributo se viene specificato PDATA. 


PDATA-NO specifica che se la procedura non è una procedura MRT, i parametri 
vengono passati alla procedura stessa. 


HIST-YES indica che le specifiche OCL contenute nella procedura devono essere 
registrate nel file cronologico. Se non è specificato il parametro HIST, si pre- 
sume HIST-YES. 


HIST-NO indica che le specifiche OCL contenute nella procedura non devono es- 
sere registrate nel file cronologico. 


REF-numero specifica il numero di riferimento per il membro. ll numero può 
avere una lunghezza massima di 6 cifre. Per esempio, 000042 è la 42esima 
revisione di un membro. 
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SUB-sottotipo specifica il sottotipo per i membri. | sottotipi validi sono: 


ARP. Membro auto report RPG 

ARS Membro a risposta automatica i 

ASM Membro assembler 

BAP Procedura BASIC (membro origine) 

BAS Membro BASIC 

BGC Diagramma grafici gestionali 

BGD Dati grafici gestionali 

BGF Tracciato grafici gestionali 

COB Membro COBOL 

DFU Membro utilità file dati 

DTA Membro dati 

FMT Membro tracciato video 

FOR Membro FORTRAN 

ICF. Membro procedura Dispositivo per le Comunicazioni Interattive 
CNFGICF 

MNU Membro menù 

MSG Membro messaggio 

PHL Membro elenco telefonico 

RPG Membro RPG 

SRT Membro Sort 

SSP Membro configurazione sistema procedura CNFIGSSP 

UNS Non specificato 

WSU Membro programma di utilità terminale 

X25 Controllo collegamento commutazione a pacchetti X.25 


specifiche per membro libreria indica le specifiche per il membro di libreria che 
viene creato. Occorre immettere almeno una specifica tra le specifiche COPY 
e CEND. 


Esempio 


Questo esempio mostra come copiare la seguente procedura in un membro di 
procedura denominato PROC1. ll nome della libreria che deve contenere la pro- 
cedura è MYLIB. Le specifiche nella procedura sono le seguenti: 


// LOAD PROGI 
// FILE NAME-FILEl 
// RUN 


La procedura esegue un programma denominato PROG1. Questa non è una pro- 
cedura MRT. 


Le specifiche richieste per creare la procedura sono le seguenti: 


// LOAD $MAINT 

// RUN 

// COPY FROM-READER,LIBRARY-P,NAME-PROC1,TO-MYLIB,RETAIN-R 
// LOAD PROG1 

// FILE NAME-FILEl 

// RUN 

// CEND 

// END 
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Cambio della dimensione della libreria o dell’indirizzazio (Procedura 
ALOCLIBR) 


Per ulteriori informazioni vedere la Procedura ALOCLIBR. 


// LOAD $MAINT 
// RUN 


// ALLOCATE LIBRNAME-nome libreria,STATUS-{ REALOC [.LIERSIZE-empiezza Libreria | 
INCR 
DECR 


|.p1RSIZE-ampiezza indirizzario | ,LOCATION-| Al 


numero blocco 





Differenze dai parametri di procedura 


STATUS-REALOC specifica che una libreria esistente deve essere modificata (rial- 
loccata). Le dimensioni specificate per LIBRSIZE e DIRSIZE devono essere 


quelle nuove. 


Esempio 1 


Questo esempio mostra una libreria denominata MYLIB che viene modificata in 
250 blocchi. La dimensione dell'indirizzario viene modificata in 25 settori. 


// LOAD $MAINT 


// RUN 
// ALLOCATE LIBRNAME-MYLIB,STATUS-REALOC,LIBRSIZE-250, 
1} DIRSIZE-25 
// END 
Esempio 2 


Questo esempio mostra la dimensione di una libreria denominata MYLIB che vie- 
ne aumentata di 50 blocchi. La dimensione dell'indirizzario è a sua volta aumen- 


tata di 10 settori. 


// LOAD $MAINT 


// RUN 

// ALLOCATE LIBRNAME-MYLIB,STATUS-INCR sLIBRSIZE-50, 
// DIRSIZE-10 

/] END 


731 


Le seguenti specifiche possono anche essere usate per modificare le dimensioni 
della libreria e sono supportate per compatibilità con il Sistema/34 IBM. 


// LOAD $MAINT 
// RUN 


DECREASE-blocchi 


// ALLOCATE | srarus-cHAncE| , li. ,[pIRSIZE-settori| 


sLIBRNAME-f nome libreria 
#LIBRARY 





STATUS-CHANGE specifica che deve essere eseguita una modifica nella dimen- 
sione di una libreria o nella dimensione di un indirizzario di libreria. Se non 
viene specificato alcun parametro STATUS, si presume STATUS-CHANGE. 


INCREASE specifica il numero di blocchi di cui deve essere aumentata la dimen- 
sione della libreria. INCREASE non può essere specificato insieme a 
DIRSIZE. 


DECREASE specifica il numero di blocchi di cui la dimensione di libreria deve 
essere diminuita. DECREASE non può essere specificato insieme a DIRSIZE. 


CEN 


DIRSIZE specifica il numero di settori per l’indirizzario di libreria. DIRSIZE 
non può essere specificato insieme a INCREASE o DECREASE. 


LIBRNAME specifica il nome della libreria di cui si deve modificare la dimensio- 
ne. Se non è specificato alcun parametro si presume la libreria di sistema 
(#LIBRARY). 


Esempio 


Per diminuire il numero di blocchi allocati ad una libreria denominata MYLiÌB 
di 20: 


// LOAD $MAINT 

// RUN 

// ALLOCATE DECREASE-20,LIBRNAME-MYLIB 
// END 
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Modifica di informazioni di membri di libreria (Procedura CHNGEMEM) 


Per ulteriori informazioni vedere la Procedura CHNGEMEM. 


// LOAD $MAINT 
// RUN 


// CHANGE NAME-fnome membro ,LIBRARY-1S ,LIBRNAME-{nome libreria 
nome membro. ALL P {grronane } 
ALL 0) 
R 
ALL 


|, NEWNAME-nome nuovo membre | È SUB-sottot ipo | 


[REF-numero riferimento | 





Esempio 


Modificare il nome del membro di procedura di libreria PAYROLL in PAY- 
ROLL2 nella libreria denominata FINANCE: 


// LOAD $MAINT 


// RUN 
// CHANGE NAME-PAYROLL1,LIBRARY-P,LIBRNAME-FINANCE, 


NEWNAME-PAYROLL2 
// END 
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Riunione di spazio di libreria inutilizzato (Procedura CONDENSE) 


Per ulteriori informazioni vedere la Procedura CONDENSE. 


// LOAD $MAINT 
// RUN 


// COMPRESS a Di 


#LIBRARY. 


AH 


// END 





Esempio 
Per condensare la libreria di sistema (#LIBRARY): 


// LOAD $MAINT 
// RUN 


// COMPRESS LIERNAME-#LIBRARY 
// END 
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Copia di membri da una libreria in un'altra (Procedura LIBRLIBR) 


Per ulteriori informazioni vedere la Procedura LIBRLIBA. 


// LOAD $MAINT 
// RUN 
nome libreria da cui 
// COPY FROM-f copiare ,LIBRARY-{S |,NAME-{nome membro 
FI P nome membro.ALL 


0, ALL 
R 
ALL 


nome libreria che 


TO-J riceve copia , NEWNAME-nome nuovo membro lisnagi: 
FI R 


sOMIT-{nome membro 
nome membro. ALL 
SYSTEM 





Differenze dai parametri di procedura 
NAME-ALL specifica che tutti i membri, salvo i membri forniti dalla IBM, devo- 
no essere copiati o listati quando viene specificato LIBRARY-ALL o che de- 


vono essere copiati tutti i membri del tipo specificato dal parametro LIBRA- 
RY (compresi i membri forniti dalla IBM). 


OMIT specifica il nome di uno o più membri da omettere dalla copia: 
nome membro specifica i membri che devono essere omessi. 


nome membro.ALL specifica che devono essere omessi tutti i membri i cui 
nomi iniziano con i caratteri indicati. E' possibile specificare un massimo di 


7 caratteri. 


SYSTEM specifica che devono essere omessi tutti i membri di libreria forniti 
dalla IBM. 


La procedura LIBRLIBR omette sempre i membri di libreria forniti dalla IBM. Se non 
è specificato OMIT - SYSTEM, sono copiati sia i membri IBM che non IBM. 
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Esempio 1 


Copiare tutti i membri di libreria denominati TEST da una libreria denominata 
MYLIB in una libreria denominata YOURLIB e sostituire tutti i membri deno- Cai 
minati TEST in YOURLIB. 


// LOAD $MAINT 

// RUN 

// COPY FROM-MYLIB,TO-YOURLIB, NAME-TEST,LIBRARY-ALL, 
// RETAIN-R 

// END 


Esempio 2 


Copiare tutte le procedure che iniziano con PAY da una libreria denominata 
MYLIB in una libreria denominata YOURLIB. In ogni caso, i membri di libreria 
che iniziano con PAYR non devono essere copiati. 


// LOAD $MAINT 

// RUN 

// COPY FROM-MYLIB,TO-YOURLIB,NAME-PAY.ALL,LIBRARY-P, 
11 RETAIN-R,OMIT-PAYR.ALL 

// END 
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Copia di membri da una libreria (Procedura FROMLIBR) 
Per ulteriori informazioni vedere la Procedura FROMLIBR, 


Queste specifiche consentono di eseguire altre attività oltre a quelle consentite 
dalla procedura FROMLIBR. E' possibile per esempio: 


e Creare un file su minidisco in formato base di interscambio che contiene uno 
o più membri di libreria. 


e  Omettere unoo più membri dall'operazione di copia. 


Per creare un file nel modo a settori 


I file nel modo a settori sono creati specificando il parametro TO-DISK senza il 
parametro RECL. Una copia nel modo a settori può essere specificata per qual- 
siasi tipo di membro di libreria (origine, procedura, oggetto o subroutine). Nel 
modo a settori, le copie sono in formato di sistema e contengono informazioni 
di controllo e numeri PTF (riparazioni provvisorie del programma) per qualsiasi 
PTF che è stato applicato ad un membro, seguite dal membro così come esiste 
nella libreria. La lunghezza di record di un file nel modo a settori è 8. 


// LOAD $MAINT 


// FILE NAME-fnome file sUNIT-f Il 
nome membro F1 
TI 


T2 


// RUN 


// COPY FROM-fnome lo DISK ,FILE-f nome file - 
F1 TAPE nome membro 


NAME- {nome membro ,LIBRARY-f S [a0o- {no }I 


nome membro.ALI YES 


P 
ALL . R 
0 


YES nome membro 


sPTF- ta } sOMIT-| SYSTEM 
nome membro. ALL 
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Differenze dai parametri di procedura 


| i Se viene specificato T1, T2 0 TC come parametro UNIT nella specifica FILE, deve 
essere specificato RECFM-FB ed un ID di volume. 


PTF specifica se devono essere copiati i membri di libreria che hanno riparazioni 
provvisorie di programma (PTF). Il parametro PTF è ammesso soitanto per 
i file nel modo a settori. 


NO specifica che i PTF non hanno particolare importanza. Se non viene spe- 
cificato PTF, si presume PTF-NO. 


YES specifica che devono essere copiati soltanto i membri cui sono stati ap- 
plicati i PTF. 


OMIT specifica il nome di uno o più membri di libreria da omettere dalla fun- 
zione di copia. 


nome membro specifica che devono essere omessi dalla funzione copia i 
membri aventi il nome specificato. 


nome membro.ALL specifica che dalla funzione copia devono essere omessi 
tutti i membri i cui nomi iniziano con i caratteri specificati. E’ possibile 
specificare un massimo di 7 caratteri. 


SYSTEM indica che devono essere omessi tutti i membri forniti dalla IBM. 


Per creare un file nel modo a record 


Il parametro RECL indica che la copia di un file è nel modo a record e non nel 
modo a settori. ll modo a record può essere specificato soltanto per i membri 
di procedura o origine. Le copie dei membri di procedura e origine eseguite riel 
modo a record sono precedute da una specifica COPY e seguite da una specifica 
CEND. 


// LOAD $MAINT 


nome membro Fl 
TI 
T2 


// FILE i file i Il 


// RUN 
// COPY SA ind de file È 


Fl TAPE nome membro 
NAME-{ nome membro sLIBRARY-[S , (RECL-lunghezza record 
nome membro.ALL P ADD-YES 


ALL ALL 


sOMIT-{ SYSTEM 3 BASIC-{NO »SVATTR-jNO 
nome membro YES YES 
nome membro.ALL 
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pera 


Per ulteriori informazioni sulla specifica FILE, vedere la Specifica OCL FILE 
{per i file su disco) e la Specifica OCL FILE {per i file su minidisco) o la Speci- 


fica OCL FILE (per i file su nastro). 


Differenze dai parametri di procedura 


Se viene specificato T1, T2 o TC come parametro UNIT nella specifica FILE, deve 
essere specificato RECFM-FB ed un ID di volume. 


TO-DISK specifica che i membri di libreria devono essere copiati su un file disco 
o minidisco, 


TO-TAPE specifica che i membri di libreria devono essere copiati su un file 
nastro. 


LIBRARY-ALL. ALL specifica che tutti i membri origine (S), di procedura (P), 
di subroutine (R) ed oggetto (0) devono essere copiati quando viene creato 
un file nel modo a settori. Quando viene creato un file nel modo a record, 
ALL specifica che devono essere copiati tutti i membri origine (S) e proce- 
dura (P). 


ADD specifica se devono essere aggiunti uno o più membri di libreria ad un file 
che già contiene altri membri. E' possibile specificare YES o NO. Se non è 
specificato alcun parametro, si presume ADD-NO. 


Quando si aggiunge un membro ad un file su disco, il file deve contenere spazio inu- 
tilizzato sufficiente per accogliere il membro. Quando sì aggiunge un membro ad un 
file su minidisco o nastro, il file deve essere l’ultimo attivo (non scaduto) sul minidi- 
sco. 


H parametro RECL non è ammesso se viene specificato ADD-YES. Per i file 
nel modo a record, la lunghezza di record è determinata dalla lunghezza di 
record del file esistente. 


RECL specifica la lunghezza di record, in byte di un membro origine o di proce- 
dura. La lunghezza di record può essere compresa tra 40 e 120 ma occorre 
specificare una lunghezza di record di almeno 73 bytes se si specifica anche 
SVATTR-YES, altrimenti viene emesso un messaggio di errore. La lunghezza 
di record della specifica COPY non sarà mai minore di 73 byte se viene spe- 
cificato SVATTR. 
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BASIC specifica se l'emissione copiata deve essere inserita in un file su mindisco 
in formato base di interscambio. 


NO specifica che non deve essere creato un file su minidisco in formato base 
di interscambio. Se non viene specificato BASIC, si presume BASIC-NO. 


YES specifica che deve essere creato un minidisco in formato base di inter- 
scambio. 


Nota: Se viene specificato ADD-YES, non deve essere specificato BASIC-YES. 
Quando si aggiunge un record ad un file in formato base di interscambio, 
non si deve specificare BASIC-YES. 


Esempio 1 


Questo esempio mostra come salvare un membro di procedura di libreria denomi- 
nato TEST su un minidisco avente un ID di volume di VOL003. La procedura 
è nella libreria denominata MYLIB ed ii minidisco è nella posizione di caricatore 
M2.05. 


// LOAD $MAINT 


// FILE NAME-TEST,UNIT-I1,PACK-VOL003, LOCATION-M2.05,AUTO-NO 


// RUN 


// COPY FROM-MYLIB,TO-DISK,LIBRARY-P,NAME-TEST,FILE-TEST 


// END 


Esempio 2 


Questo esempio mostra come creare un file nel modo a record da un membro 
origine di libreria. Il nome del file deve essere FILE1 e deve avere una lunghezza 
di record di 80. Il membro di libreria è denominato TEST ed è contenuto nella 
libreria denominata MYLIB. 


// LOAD $MAINT 
// FILE NAME-FILEl,UNIT-F1,BLOCKS-30 


// RUN 
// COPY FROM-MYLIB,TO-DISK, LIBRARY-S,NAME-TEST,FILE-FILF1, 
11 RECL-80 
// END 
Esempio 3 


Questo membro mostra come creare su minidisco un file nel modo a record in 
formato base di interscambio da un membro origine di libreria. Il nome del file 
deve essere FILE2 e deve avere una lunghezza di record di 80. Il membro di li- 
breria è denominato TEST e si trova nella libreria denominata MYLIB..II mini- 
disco da usarè ha un ID di volume di VOL001. 


// LOAD $MAINT 
// FILE NAME-FILE2,UNIT-I1,PACK-VOLOOl 


// RUN 

// COPY FROM-MYLIB,TO-DISK,LIBRARY-S s NAME-TEST,FILE-FILE2, 
11 RECL-80,BASIC-YES 

// END 


Copia di membri su una libreria (Procedura TOLIBR) 


Per ulteriori informazioni vedere la Procedura TOL/BR. 


// LOAD $MAINT 

// FILE NAME-nome file ,UNIT-|F1 
Il 
TI 
T2 


// RUN 


// COPY TO-fnome libreria|,FROM-DISK,FILE-nome file ,NAME-fnome membro 
Fl nome membro.ALL 


R 


paenass-(o) 200 NO | [|.sUB-sottotipo | ,LIBRARY-{ S 


numero S| 


s OMIT-NEW 





Sono presentati soltanto alcuni dei parametri per ia specifica OCL FILE. Per in- 
formazioni sulla specifica OCL FILE, vedere la Specifica OCL FILE (per i file su 
minidisco), la Specifica OCL FILE (per i file su disco) e la Specifica OCL FILE 
(per i file su nastro). 
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Differenze dai parametri di procedura 


Se viene specificato T1 o T2 come parametro UNIT nella specifica FILE, deve 
essere specificato RECFM-FB ed un ID di volume. 


Per la specifica COPY: 


FROM-DISK indica che i membri di libreria vengono copiati da un file su disco 
o su minidisco. i 


FROM-TAPE indica che i membri di libreria devono essere copiati da un file su 
nastro. 


RETAIN-P indica che se nella libreria esiste già un membro con lo stesso nome, 
deve essere visualizzato un messaggio. E’ possibile quindi decidere se sostitui- 
re il membro duplicato. Se non viene specificato alcun parametro RETAIN, 
si presume P. 


RETAIN-R specifica che il membro duplicato deve essere sostituito senza mes- 
saggio. 


PTF specifica che devono essere copiati nella libreria i membri al cui programma 
sono state applicate variazioni provvisorie (PTF). Il parametro PTF può esse- 
re specificato soltanto per i file su disco o su minidisco nel modo a settori. 


NO specifica che i PTF non hanno particolare importanza. Un membro di 
libreria viene copiato indipendentemente dal suo stato PTF. Se non viene 


specificato alcun parametro, si presume NO. 


numero specifica che vengono copiati soltanto quei membri in cui è specifi- 
cato il numero di PTF. ll numero può andare da 1 a 65535. 


OMIT-NEW specifica che non devono essere copiati i nuovi membri. 


Esempio 


Copiare i membri da un file su minidisco denominato PAY in una libreria deno- 
minata MYLIB e sostituire tutti i membri duplicati. 


// LOAD $MAINT 

// FILE NAME-PAY,UNIT-Il 

// RUN 

// COPY FROM-DISK,TO-MYLIB,NAME-PAY,FILE-PAY,RETAIN-R 
// END 


Avviamento di un lavoro (Procedura JOBSTR) 


Per ulteriori informazioni vedere la Procedura JOBSTA. 


// LOAD $MAINT 


// FILE NAME-nome file ,UNIT-({Il 
TI 
T2 





TAPE Fl 


07 “COPY ia dn file se ci nia 


// END 


nome procedura [:none libreria | 


// JOBQ [priorità in coda lavori. | nome libreria |,nome procedura 





Esempio 


Copiare i membri di procedura (PROC1 e PROC2) e il membro origine 
(MEMBER) nella libreria denominata MYLIB da un file su minidisco denominato 
JOBS e quindi eseguire la procedura PROC1. Vedere la procedura JOBSTR per il 
formato del file denominato JOBS. 


// LOAD $MAINT 

// FILE NAME-JOBS,UNIT-I1l 
// RUN 

// COPY FROM-DISK,FILE-JOBS,TO-MYLIB 
// END 

PROC1,MYLIB 
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Lista dei membi e delle informazioni di libreria (Procedura LISTLIBR) 


Per ulteriori informazioni vedere la Procedura LISTLIBR. 


// LOAD $MAINT 

// RUN 

// COPY TO-PRINT, NAME-(DIR ,LIBRARY-{ S ,DISPLAY- DITA : 
nome membro P DIRINFO 
nome membro.ALL R 
ALL 0 


Fl nome membro.ALL 
SYSTEM 


FROM- { nome libreria } sOMIT-fnome membro 


a } SS |,SUB-sottotipo | 


DETAIL YES 





La specifica COPY può essere ripetuta per listare parecchi membri o librerie con 
un solo caricamento ed una sola esecuzione del programma di utilità $MAINT. 


Differenze dai parametri di procedura 
TO-PRINT specifica che l'emissione deve andare sull'unità di lista del sistema. 


OMIT specifica che dalla copia o dallo schermo devono essere omessi uno o più 
membri della libreria. 


nome membro specifica i membri che devono essere omessi. 


nome membro.ALL specifica che devono essere omessi tutti i membri i cui 
nomi iniziano con i caratteri indicati. E’ possibile indicare un massimo di 7 
caratteri. 


SYSTEM specifica che devono essere omessi tutti i membri di libreria SSP. 
La procedura LISTLIBR omette sempre i membri di libreria SSP. 
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Esempio 1 


Listare tutti i membri di procedura di libreria che hanno nomi che iniziano con 
PAY nella libreria denominata PAYLIB. In ogni caso non listare i membri che 
iniziano con PAYR. 


// LOAD $MAINT 

// RUN 

// COPY FROM-PAYLIB,TO-PRINT,NAME-PAY.ALL,LIBRARY-P, 
Li OMIT-PAYR.ALL 

// END 


Esempio 2 


Per listare tutti i membri di procedura della libreria di sistema: 


// LOAD $MAINT 


// RUN 
// COPY FROM-#LIBRARY,TO-PRINT,NAME-ALL,LIBRARY-P 


// END 


Lista di informazioni sulla libreria (Procedura LISTFILE) 


Per ulteriori informazioni vedere la Procedura LISTFILE. 


// LOAD $MAINT 

// FILE NAME-nome file,UNIT-(Il 
FI 
TI 
T2 


// RUN 


DETAIL 


// COPY e ERE file dio } 


TAPE 


// END 





Sono presentati solatnto alcuni dei parametri per la specifica OCL FILE. Per in- 
formazioni sulla specifica OCL FILE, vedere la Specifica OCL FILE (per i file 
su minidisco), la Specifica OCL FILE (per i file su disco) e la Specifica OCL 
FILE (per i file su nastro). 


Differenze dai parametri di procedura 


Se viene indicato T1, T2 o TC come parametro UNIT nella specifica FILE, deve es- 
sere indicato anche RECFM-FB. Se il file da listare da T1, T2 o TC è un file SAVE- 
LIBR, deve anche essere specificato RECL-256 e BLKL-24576. Se il file da listare 
da T1, T2 o TC è un file LIBRFILE, deve anche essere specificato RECL-256 e 
BLKL-4096. i 


Per la specifica COPY: 
TO-PRINT specifica che l'emissione deve andare sulla unità di lista del sistema. 


FROM-DISK specifica una lista da disco o minidisco. Il file deve essere definito 
da una specifica OCL FILE. 


FORM-TAPE specifica una lista da nastro. Il file deve essere definito da una spe- 
cifica OCL FILE. 
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Rimozione di membri da una libreria (procedura REMOVE) 


Per ulteriori informazioni vedere la Procedura REMOVE. 


// LOAD $MAINT 
// RUN 


// DELETE NAME-fnome membro ,LIBRARY-(S , LIBRNAME- f nome agial 
nome membro.ALL P #LIBRARY 


ALL O 
R 


ALL 


sOMIT- fnome membro [\rezamn-s]| 
nome membro.ALL 





La specifica di controllo del programma di utilità DELETE può essere ripetuta 
per rimuovere parecchi membri di libreria con un solo caricamento ed una sola 
esecuzione del programma di utilità $MAINT. 


Differenze dai parametri di procedura 


LIBRNAME-#LIBRARY specifica quali membri devono essere rimossi dalla libre- 
ria di sistema. 


OMIT-nome membro specifica che i membri con il nome indicato non devono es- 
sere rimossi dalla libreria. Il nome di membro può contenere da 1 a 8 carat- 
teri. 


OMIT-nome membro.ALL specifica che i membri che iniziano con i caratteri in- 
dicati non devono essere rimossi dalla libreria. Il nome di membro può con- 
tenere da 1 a 7 caratteri. 


RETAIN-S specifica che devono essere rimossi i membri forniti dalla IBM. Quan- 
do si stanno rimuovendo membri dalla libreria di sistema (#LIBRARY), se 
sono specificati LIBRARY-ALL e NAME-ALL, RETAIN-S non è ammesso. 


Esempio 


Rimuovere dalla libreria MYLIBR un membro origine denominato THIS, un 
membro di procedura denominato THAT ed un membro oggetto denomiato 


OTHER. 


// LOAD $MAINT 

// RUN 

// DELETE NAME-THIS,LIBRARY-S,LIBRNAME-MYLIB 
// DELETE NAME-THAT,LIBRARY-P,LIBRNAME-MYLIB 
// DELETE NAME-OTHER,LIBRARY-O,LIBRNAME-MYLIB 
// END 
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Salvataggio di una libreria (Procedura SAVELIBR) 


Per ulteriori informazioni vedere la Procedura SA VELIBA. 


LOAD $MAINT 


FILE NAME-#IPLBOOT,UNIT-I1,PACK-id volume 


FILE NAME-ome libreria ,UNIT-{F1 
Il 
TI 
T2 


RUN 
COPYLIBR FROM-nome pi co ia libreria 
TAPE 





Sono presentati soltanto alcuni dei parametri per la specifica OCL FILE, Per in- 
formazioni sulla specifica OCL FILE, vedere la Specifica OCL FILE (per i file su 
minidisco}, la Specifica OCL FILE (per i file su disco) e la Specifica OCL FILE 
(per i file su nastro, 


Differenze dai parametri di procedura 


Il file FIPLBOOT è richiesto soltanto quando si sta salvando la libreria di sistema 
(#LIBRARY); deve essere indicato nella prima specifica OCL FILE. La libreria di 
sistema non può essere salvata su nastro. 


Esempio 1 


Salvare su minidisco una libreria denominata MYLIB con un iD di volume di 
VOLOOI!. Ii minidisco è nell’alimentatore SI. 


//LOAD $MAINT 

// FILE NAME-MYLIB,UNIT-I1,PACK-VOLOO1 

// RUN 

// COPYLIBR FROM-MYLIB,TO-DISK,FILE-MYLIB 
// END 


Esempio 2 


Salvare su minidischi la libreria di sistema con I'D di volume di SYSTEM. | mini- 
dischi sono nell’alimentatore del caricatore M1, iniziando dalla posizione M1.01. 


// LOAD $MAINT 

// FILE NALE-#IPLBOOT,UNIT-I1,PACK-SYSTFEM,LOCATION-M1 
// FILE NAME-#LIBRARY,UNIT-I1,PACK-SYSTEM,LOCATION-M1 
// RUN 

// COPYLIBR FROM-#LIBRARY,TO-DISK,FILE-#LIBRARI 

// END 


Ripristino di una libreria (procedura RESTLIBR) 


Per ulteriori informazioni vedere la Procedura RESTLIBA. 


// LOAD $MAINT 

// FILE NAME-$IPLBOOT,UNIT-Il 

// FILE NAME-nome libreria ,UNIT-{Il 
Il 
T2 

// RUN 


/] COPYLIBR i libreria,FILE-nome libreria 
TAPE 


| LIERSIZE-ampiezza libreria | |.DIRSIZE-ampiezza indirizzario | 


, LOCATION-{ Al 
AQ 
A3 


Ah 
numero blocco si 





Per ulteriori informazioni sulle specifiche FILE, vedere la Specifica OCL FILE 
(per i file su minidisco) e la Specifica OCL FILE (per i file su nastro). Il file 
#IPLBOOT occorre soltanto quando viene ripristinata la libreria di sistema. La 
libreria di sistema non può essere ripristinata da nastro. 
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Esempio 1 


Questo esempio mostra il ripristino di una libreria denominata MYLIB. La di- 
mensione della libreria viene modificata in 250 blocchi. La dimensione dell’indi- 


rizzario non viene modificata. 


// LOAD $MAINT 
// FILE NAME-MYLIB,UNIT-Il 


// RUN 
// COPYLIBR FROM-DISK,TO-MYLIB,FILE-MYLIB,LIBRSIZE-250 


// END 


Esempio 2 


Questo esempio mostra la libreria di sistema che viene ripristinata. 


// LOAD $MAINT 

// FILE NAME-#IPLBOOT,UNIT-Il 

// FILE NAME-#LIBRARY,UNIT-Il 

// RUN 

// COPYLIBR FROM-DISK,TO-#LIBRARY,FILE-#LIBRARY 


// END 


PE 


Specifiche COPY e CEND 
Quando si copia uno o più membri di libreria su un file nel modo a record, il 
programma dì utilità $MAINT aggiunge una specifica COPY prima di ciascun 


membro ed una specifica CEND dopo ciascun membro. 


La specifica COPY ha il seguente formato: 





// COPY NAME- nome sani [| prn-1r8] | epara-no| [,HIStO-N0| 
P 


DATE-nn/ eg/ aal |: TIME-hhvm | [.Rer-annnnn | L SUB-t ipo] 


NAME-nome membro specifica il membro di libreria da inserire nella libreria spe- 
cificata. 





LIBRARY-S specifica che si tratta di un membro origine. 
LIBRARY-P specifica che si tratta di un membro di procedura. 


MRT-YES specifica che il membro di procedrua è una procedura a terminali ri- 
chiedenti multipli (MRT). Se non viene specificato MRT-YES, il membro 
non è una procedura MRT. 


PDATA-VYES specifica che è possibile passare i dati (non i parametri) al comando 
di procedura, facendo sì che la procedura venga eseguita. | dati iniziano con 
il primo carattere diverso dallo spazio in bianco che segue il nome della pro- 
cedura e termina con l’ultimo carattere diverso dallo spazio in bianco nella 
specifica. l dati vengono passati in occasione della prima operazione di im- 
missione dal terminale video richiedente dal primo programma nella procedu- 
ra. Se viene specificato PDATA-YES, ogni procedura MRT ha questo indica- 
tore. 


Se non viene specificato PDATA-YES e se la procedura non è una procedura 
MRT, i parametri vengono passati alla procedura. 


HIST-NO indica che ie specifiche OCL contenute nella procedura non devono 
essere registrate nel file cronologico. Se non viene indicato HIST-NO, le spe- 
cifiche OCL contenute nella procedura sono registrate nel file cronologico. 


DATE specifica la data in cui il membro è stato creato o è stato modificato per l’ulti- 
ma volta. La data deve essere indicata nella stessa forma della data di sessione. 


x 


TIME specifica l'ora in cui il membro è stato creato o modificato per l'ultima 
volta. L'ora è nella forma: hhmm (ore, minuti). 


REF specifica il numero di riferimento del membro. ll numero è lungo sei cifre 


ed è allineato a destra (ad esempio, 000042 è la 42-esima revisione di un 
membro). 
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SUB specifica il sottotipo di membro di libreria. Sono indicati i seguenti sotto- 
tipi: 


ARP Membro auto report RPG x 
ARS Membro a risposta automatica 
ASM Membro assembler 
BAP Procedura BASIC (membro origine) 
BAS Membro BASIC 

| BGC Diagramma grafici gestionali 
BGD Dati grafici gestionali 
BGF Tracciato grafici gestionali 
COB Membro COBOL 
CSM Membro Comunicazioni e Gestione Sistemi 
CSP _ Membro prodotto sistema 
DFU Membro utilità file dati 

| DLS Membro servizi libreria documenti 
DTA Membro dati 
FMT Membro tracciato video 
FOR Membro FORTRAN 
ICF. Membro procedura Dispositivo per le Comunicazioni Interattive 
; CNFGICF 
| KEY Procedura KEYS 


MNU Membro menù 

MSG Membro messaggi 

PHL Membro elenco telefonico 

QDE Membro immissione dati Query 

QRY Membro Query 

RPG Membro RPG 

SRT Membro Sort 

SSP Membro di configurazione sistema procedura CNFIGSSP 
UNS Non specificato 

WSU Membro programma di utilità terminale va 
X25 Controllo collegamento commutazione a pacchetti X.25 


La specifica CEND ha il seguente formato: 


// CEND 
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PROGRAMMA DI UTILITA’ $MGBLD 


Il programma di utilità $MGBLD consente di creare membri oggetto di messaggio 
da membri origine di messaggio. 


Per ulteriori informazioni vedere la Procedura CREATE. 


// LOAD $MGBID 
// RUN 


// MGBID SOURCE-nome membro origine a }| 
7 YES 


,LIBRARY-fnome ani sHALT-fvEes| | |,SSP-fNO 
#LIBRARY NO YES 





Differenze dai parametri di procedura 


SSP specifica se il membro oggetto deve essere un membro SSP. YES specifica 
che il membro oggetto che viene creato è un membro SSP e non può essere 
rimosso usando la procedura REMOVE. NO indica che il membro oggetto 
è un membro dell'utente e che può essere rimosso usando la procedura 
REMOVE. Se non viene indicato il parametro SSP, si presume NO. 


Esempio 


Per generare un membro oggetto messaggio da un membro origine denominato 
MESSAGES che è contenuto nella libreria MYLIB, occorre immettere quanto 


segue: 


// LOAD $MGBLD 

// RUN 

// MGBLD SOURCE-MESSAGES,LIBRARY-MYLIB 
// END 
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PROGRAMMA DI UTILITA’ $MMSP 


Il programma di utilità $MMSP consente di interrompere la funzione di controllo 
di una linea multipunti BSC. 





Per ulteriori informazioni vedere la Procedura STOPM. 
LOAD $MMSP 
/} RUN 
// STOPM LINE-numero iinea 
// END 
Esempio 
Questo esempio mostra come interrompere la linea 1 a controllo automatico. 
// LOAD $MMSP 
/} RUN 
// STOPM LINE-1 
// END 
an 


PROGRAMMA DI UTILITA’ $MMST 


Il programma di utilità $MMST consente di avviare la funzione di controllo au- 
tomatico di una linea multipunti BSC. 





pai 
Per ulteriori informazioni vedere la Procedura STARTM. 
// LOAD $MMST 
// RUN 
// STARTM LINE-numero linea i STATION-indirizzo terminale 
A 
// END 
Esempio 
Questo esempio mostra come specificare che la linea 1 deve controllarsi automati 
camente alla ricerca di un indirizzo di stazione EBCDIC di CA. 
// LOAD $MMST 
// RUN 
// STARTM LINE-1,CODE-E,STATION-Ch 
// END 
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PROGRAMMA DI UTILITA’ $PACK 


“Il programma di utilità $PACK consente di riunire tutto lo spazio su disco inuti- 
lizzato. 


Per ulteriori informazioni vedere la Procedura COMPRESS. 


// LOAD $PACK 


// RUN 








Esempio 
Per comprimere lo spazio libero sul disco: 


// LOAD $PACK 
// RUN 
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PROGRAMMA DI UTILITA' $PNLM 


Il programma di utilità $PNLM consente di creare o aggiornare elenchi telefonici 
per la funzione di chiamata automatica. 


Per ulteriori informazioni vedere la Procedura DEFINEPN. 





// MEMBER PROGRAM1-#PN#M1, PROGRAM2-#PN#M2 
// LOAD $PNIM 
// RUN 





Esempio 
Per creare un elenco telefonico occorre immettere: 


/} MEMBER PROGRAM1-#PN#M1 , PROGRAM2—#PN#M2 
// LOAD $PNIM 
// RUN 
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‘ PROGRAMMA DI UTILITA’ $POST 
Il programma di utilità $POST consente di: 
e Copiare file su minidisco in formato speciale E (Procedura POST). 
e Listare file su minidisco in formato base di interscambio. 
Copia di file su minidisco in formato speciale E o in formato inter- 
scambio di base (Procedura POST) 
Per ulteriori informazioni vedere la Procedura POST 


Per copiare file in formato speciale E o in formato interscambio di base su o da minidisco: 


// LOAD $POST 
// FILE NAME-COPYIN,LABFI-nome file dl > 
Il 


/} FILE NAME-COPYO,LABEL-nome file CERA) 
Il 


// RUN 


// TRANSFER |100-{a ì | «cevien-runghezza chiave,KEYLOC-posizione chiave | 
YES 


,s EOD-f{ NO 
YES 





Per informazioni sulle specifiche FILE, vedere la Specifica OCL FILE (per i file 
su disco) e la Specifica OCL FILE (per i file su minidisco). 


Esempio 


Questo esempio mostra come creare su disco un file a indici denominato FILE2 
(con le chiavi nelle posizioni da 1 a 4) da un file su minidisco in formato speciale 
E denominato FILE? e ricercare i fine dati speciali. 


// LOAD $POST 

// FILE NAME-COPYIN,UNIT-I1l,LABEL-FILE2 

// FILE NAME-COPYO,UNIT-F1,LABEL-FILE2 

// RUN 

4 TRANSFER ADD-NO,KEYLOC-1,KEYLEN-},FOD-YES 
END 
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Lista di file su minidisco in formato base di interscambio 


Per listare i file su minidisco in formato base di interscambio: 


// LOAD $POST 
// FILE NAME-COPYIN,LABEL-nome file di immissione ,UNIT-Il 
// RUN 


// DISPLAY [FR0-prino record |. TO-ultimo rec ord) | 


// END 





Sono presentati soltanto alcuni dei parametri per la specifica OCL FILE. Per in- 
formazioni sulla specifica OCL FILE, vedere la Specifica OCL FILE (per i file su 
minidisco). ° 


La specifica di congrollo programma di utilità DISPLAY consente di listare file 
su minidisco in formato base di interscambio sull’unità di lista di sistema. E’ pos- 
sibile usare il comando STATUS SESSION per determinare l’unità di lista del si- 
stema. 


FROM-primo record specifica il numero del primo record da listare. Se non è 
specificato il valore del primo record, il file viene listato iniziando con il pro- 
mo record nel file, 


TO-ultimo record specifica il numero dell'ultimo record da listare. Se non viene 
specificato alcun valore di record, il file viene listato terminando con l’ultimo 
record nel file. 


Esempio 


Questo esempio mostra come listare un file su minidisco in formato base di inter- 
scambio denominato FILE3: 


// LOAD $POST 

// FILE NAME-COPYIN,UNIT-Il,LABEL-FILE3 
// RUN 

// DISPLAY 

// END 


759 


PROGRAMMA DI UTILITÀ $PRCED 


Il programma di utilità $PRCED permette di aggiungere, rimuovere, o aggiornare i 
profili di ubicazione nel file delle identificazioni utente. 


Vedere la «Procedura SECEDIT» per ulteriori informazioni. 


// LOAD $PRCED 


// RUN 





Esempio 
Editare i profili di ubicazione nel file identificazioni utente. 
// LOAD $PRCED 
// RUN 
PROGRAMMA DI UTILITÀ $PRCLT 


Il programma di utilità $PRCLT permette di listare i profili di ubicazione nel file delle iden- 
tificazioni utente. 


Vedere la Procedura SECLIST per ulteriori informazioni. 


// LOAD SPRCLT 


// RUN 





Esempio 
Listare i profili di ubicazione nel file delle identificazioni utente. 


// LOAD $PRCLT 
// RUN 
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PROGRAMMA DI UTILITA’ $PRLST 


Il programma di utilità SPRLST consente di listare i profili utente nel file ID degli utenti. 


Per ulteriori informazioni vedere la Procedura SECLIST. 


// LOAD $PRLST 
// RUN 


// OPTIONS ROSE 
NOPW 


// END 





Esempio 


Listare i profili utente nel file ID degli utenti. 


Il LOAD $PRLST 
4 RUN 

Lu / OPTIONS PSWDISP-NOPW, LSTFRMT-USERID 
H END 


| PROGRAMMA DI UTILITÀ $PRPWD 
di: | Il programma di utilità $PRPWD consente di modificare ia parola d'ordine. 


| Vedere la procedura ‘’PASSWORD’’ per maggiori informazioni. 









// LORD $PRPWD 
// RUN 






| Esempio 


[ Modificare la parola d'ordine. 


/ LOAD $PRPWD 
// RUN 
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PROGRAMMA DI UTILITA’ $PRUED 


Il programma di utilità $PRUED consente di aggiungere, rimuovere, o aggiornare i profili 
utente nel file ID degli utenti. _ 


Per ulteriori informazioni vedere la Procedura SECEDIT. 


// LOAD $PRUED 


// RUN 





Esempio 
Editare i profili utente nel file ID degli utenti. 
// LOAD $PRUED 
// RUN 
PROGRAMMA DI UTILITA’ $PRUID 
ll programma di utilità $PRUID consente di: 
e Creareo rimuovere il file ID degli utenti. 
e Attivareo disattivare la riservatezza mediante parola d'ordine. 
e Attivareo disattivare la riservatezza mediante tesserino di riconoscimento. 


C) Avviare o arrestare il controllo data parole d'ordine. 


Per ulteriori informazioni vedere la Procedura SECDEF. 


// LOAD $PRUID 
// RUN 


// OPTIONS CONTROL-f CREATE 
DELETE 


ACTPW 
DEACTPW 
ACTBDG 
DEACTBDG 





Esempio 
Creazione del file ID degli utenti. 


// LOAD $PRUID 

// RUN 

// OPTIONS CONTROL-CREATE dr 
// END 
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PROGRAMMA DI UTILITA’ $PRURS 
Il programma di utilità $PRURS consente di ripristinare il file ID degli utenti. 


Per ulteriori informazioni vedere la Procedura SECREST. 


LOAD $COPY 
FILE NAME-COPYIN,LABEL-nome RR volume 
1 


FILE NAME-COPYO,LABEL-#SECREST,RETAIN-J 
RUN 


COPYFILE [ovreur- s| 


END 

LOAD $PRURS 

FILE NAME-$SECREST,LABEL-#SECREST,RETAIN-S 
RUN 


RESTORE i di i 
0 : 


END 


Sono presentati soltanto alcuni dei parametri per la specifica OCL FILE. Per ul- 
teriori informazioni sulla specifica OCL FILE, vedere la Specifica OCL FILE {per 
i file su disco), la Specifica OCL FILE (per i file su uaiABco) e la Specifica 
OCL FILE (per i file su minidisco). 


Differenze dai parametri di procedura 


OUTPUT-S è richiesto quando il file viene ripristinato da minidisco. Non deve es- 
sere usato per il disco o per il nastro. 


/ 
NEWSIZE-0 specifica che la dimensione del file non deve essere modificata. 


Esempio 


Ripristinare il file ID degli utenti. II file è denominato UVIDFILE ed è contenuto 
in un minidisco avente un ID di volume di IBM. 


// LOAD $COPY 

// FILE NAME-COPYIN,LABEL-RESFILE,UNIT-I1,PACK-IBM 
// FILE NAME-COPYO,LABEL-#SECREST,RETAIN-J 

// RUN 

// COPYFILE OUTPUT-S 

/} END 

// LOAD $RRSTR 

/{ FILE NAME-+#SECREST,LABEL-#SECREST,RETAIN-S 
// RUN 

// RESTORE NEWSIZE-O 

// END 
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PROGRAMMA DI UTILITA’ $PRUSV 
ll programma di utilità $PRUSV consente di salvare il file ID degli utenti. 
Per ulteriori informazioni vedere la Procedura SECSAVE. 
LOAD $PRUSV 
RUN 


LOAD $COPY 
FILE NAME-COPYIN,LABEL-#SECCOPY,RETAIN-S 





Il 


FILE NAME-COPYO, LABEL-nome ARI 


RUN 
COPYFILE [ourPUr- s | 


END 





Sono presentati soltanto alcuni dei parametri per la specifica OCL FILE. Per ul- 
teriori informazioni sulla specifica OCL FILE, vedere la Specifica OCL FILE (per 
i file su disco), la Specifica OCL FILE (per i file su minidisco) e la Specifica 
OCL FILE (per i file su nastro). 


Differenze dai parametri di procedura 


OUTPUT-S è indispensabile quando il file viene salvato su minidisco. Non deve 
essere usato per il disco o per il nastro. Von 


Esempio 


Salvare il file ID degli utenti. Il file è denominato UIDFILE e deve essere conte- 
nuto su un minidisco avente un ID di volume di IBM. 


// LOAD $PRUSV 

// RUN 

// LOAD $COPY 

// FILE NAME-COPYIN,LABEL-#SECCOPY,RETAIN-S 

// FILE NAME-COPYO,LABEL-UIDFILE,UNIT-Il,PACK-IBM 
// RUN 

// COPYFILE OUTPUT-S 

// END 
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PROGRAMMA DI UTILITA’ $RENAM 


Il programma di utilità $RENAM consente di ridenominare un file, una libreria o una 


cartella. 


Per ulteriori informazioni vedere la Procedura RENAME. 


// LOAD $RENAM 
// RUN 


// RENAME LABEL-nome attuale, NEWLABEL-nuovo nome |,DATE-(mmggaa 


Egnmaa 
aamm 
66 ] 


La specifica RENAME può essere ripetuta per ridenominare parecchi file o libre- 
rie con un solo caricamento ed una sola esecuzione del programma di utilità 


$RENAM. 


Esempio 


Cambiare il nome di un file esistente da OLDPAY a NEWPAY, cambiare questo 
in quello e cambiare MYLIB in YOURLIB. 


// LOAD $RENAM 
// RUN 

// RENAME LABEL-OLDPAY, NEWLABEL-NEWPAY 
// RENAME LABEL-THIS,NEWLABEL-THAT 

// RENAME LABEL-MYLIB,NEWLABEL-YOURLIB 
// END 
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PROGRAMMA DI UTILITA’ $RREDT 


Il programma di utilità $RRDT permette di aggiungere, rimuovere o aggiornare informa- 
zioni riguardo a file, librerie, e gruppi nel file di riservatezza delle risorse. 





dA 
Per ulteriori informazioni vedere la Procedura SECEDIT. Dr 
// LOAD $RREDT 
// RUN 
Esempio 
Editare le informazioni riguardo ai file, librerie, e gruppi nel file di riservatezza delle risor- 
se. 
// LOAD $RREDT 
// RUN 
Pe 
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PROGRAMMA DI UTILITA’ $RRESC 
Il programma di utilità $RRESC consente di: 
e Creareo rimuovere il file di riservatezza delle risorse. 


e  Attivareo disattivare la riservatezza delle risorse. 


// LOAD $RRESC 
// RUN 


// OPTIONS CONTROL-|CREATE 


DELETE 
ACTRES 
DEACTRES 


Esempio 
Creare il file di riservatezza delle risorse. 


// LOAD $RRSC 

// RUN 

// OPTIONS CONTROL-CREATE 
// END 
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PROGRAMMA DI UTILITA’ $RRLST 


li programma di utilità $RRLST permette di listare informazioni circa file, librerie, e grup- 
pi nel file di riservatezza delle risorse. 





Per ulteriori informazioni vedere la Procedura SECLIST. 
// LOAD $RRLST 
// RUN 
// OPTIONS LFORMAT-fOWNERID),LQUALFR-(USER 
RNAME ALL 
USERID 
Esempio 
Listare informazioni circa file, librerie, e gruppi nel file di riservatezza delie risorse. 
// LOAD $RRLST 
// RUN 
// OPTIONS LFORMAT-RNAME,LQUA LFR-ALL 
// END 
2: 
FTA 
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PROGRAMMA DI UTILITA’ $RRSAV 


Il programma di utilità $RRSAV consente di salvare il file di riservatezza delle 
risorse. 


Per ulteriori informazioni vedere la Procedura SECSAVE. 


LOAD $RRSAV 

RUN 

LOAD $COPY 

FILE NAME-COPYIN,LABEL-#SECCOPY,RETAIN-S 


FILE NAME-COPYO, LABEL-nome e) 


JI 
RUN 


COPYFILE [ovrrur- s| 


END 








Sono presentati soltanto alcuni dei parametri per la specifica OCL FILE. Per ul- 
teriori informazioni sulla specifica OCL FILE, vedere la Specifica OCL FILE (per 
i file su disco), la Specifica OCL FILE (per i file su minidisco) e la Specifica 
OCL FILE (per i file su nastro). ' 


Differenze dai parametri di procedura 


OUTPUT-S è richiesto quando il file viene salvato su minidisco. Non deve essere 
usato per il disco o per il nastro. 


Esempio 


Salvare il file della riservatezza delle risorse. Il file è denominato RESFILE e deve 
essere contenuto su un minidisco avente un ID di volume di IBM. 


// LOAD $RRSAV 

// RUN 

// LOAD $COPY 

// FILE NAME-COPYIN,LABEL-#SECCOPY,RETAIN-S 

// FILE NAME-COPYO,LABEL-RESFILE,UNIT-I1,PACK-IBM 
// RUN 

// COPYFILE OUTPUT-S 

// END 
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PROGRAMMA DI UTILITA’ $RRSTR 


Il programma di utilità $RRSTR consente di ripristinare il file di riservatezza del- 
le risorse. 


Per ulteriori informazioni vedere la Procedura SECREST. 


LOAD $COPY 
FILE NAME-COPYIN,LABEL-nome file I sPACK-id volume 
Il 


FILE NAME-COPYO,LABEL-#SECREST,RETAIN-J 
RUN 


COPYFILE [ovrevr- s | 


END 

LOAD $RRSTR 

FILE NAME-#SECREST,LABEL-#SECREST,RETAIN-S 
RUN 


RESTORE e di Ri 
0) 


END 


Sono presentati soltanto alcuni dei parametri per la specifica OCL FILE. Per ulte- 
riori informazioni sulla specifica OCL FILE, vedere la Specifica OCL FILE (per i 
file su disco), la Specifica OCL FILE (per i file su minidisco) e la Specifica OCL 
FILE (per i file su nastro). 


Differenze dai parametri di procedura 


OUTPUT-S è indispensabile quando il file viene ripristinato da minidisco. Non 
deve essere usato per il disco o per il nastro. 


NEWSIZE-0 specifica che la dimensione del .file non deve essere modificata. 


Esempio 


Ripristinare il file di riservatezza delle risorse. Il file è denominato RESFILE ed è 
contenuto in un minidisco avente un ID. di volume di IBM. 


LOAD $COPY 

FILE NAME-COPYIN,LABEL-RESFILE,UNIT-I1,PACK-IBM 
FILE NAME-COPYO,LABEL-#SECREST,RETAIN-j 
RUN 

COPYFILE OUTPUT-S 

END 

LOAD $RRSTR 

FILE NAME-#SECREST,LABEL-#SECREST,RETAIN-S 
RUN 

RESTORE NEWSIZE-O 

END 
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PROGRAMMA DI UTILITÀ $RRTED 
Il programma di utilità $RRTED permette di aggiungere, rimuovere, o aggiornare infor- 
mazioni circa le cartelle, membri di cartella, e liste di autorizzazione nel file di riservatezza 


delle risorse, 


Vedere la Procedura SECEDIT per ulteriori informazioni. 


// LOAD S$RRTED 


// RUN 





Esempio 


Editare informazioni circa cartelle, membri di cartella, e liste di autorizzazione nel file di ri- 
servatezza delle risorse. 


// LOAD $RRTED 
// RUN 


PROGRAMMA DI UTILITÀ $RRTLT 


Il programma di utilità $ARTLT permette di listare informazioni circa cartelle e liste di au- 
torizzazione nel file di riservatezza delle risorse. 


Vedere la Procedura SECLIST per ulteriori informazioni. 


// LOAD $RRTLT 

// RUN 

// OPTIONS LFORMAT -\OWNERIDf, LQUALFR dia 
RNAME ALL 
USERID 


// END 





Esempio 
Listare informazioni circa cartelle e liste di autorizzazioni nel file di riservatezza delle risorse. 


// LOAD $RRTLT 

// RUN 

// OPTIONS LFORMAT-RNAME, LQUALFR-ALL 
// END 
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PROGRAMMA DI UTILITA’ $SETCF 


Il programma di utilità $SETCF consente di: 


Cambiare uno o più attributi di linee di comunicazione, e di parametri BSC 
a blocchi o di parametri SDLC per i programmi che vengono eseguiti da un 
terminale video (Procedura ALTERCOM). 


Stabilire elementi di ambiente del terminale video, ad esempio la stampatrice 
per l'emissione del terminale video (Procedura SET). 


Specificare informazioni sulla stampatrice usata per l'emissione del tasto 
Print (Procedura PRINTKEY). 


Variazioni di attributi di comunicazioni (Procedura ALTERCOM) 


Per ulteriori informazioni vedere la Procedura AL TERCOM. 


// LOAD $SETCF 
// RUN 

// SETA |LNUM-f1 ,LINE-f S ,SWTYP-{ AA ,REMID- f id remoto 
2 N MA fi 

3 M MC 

ù 


ii ds) ice tributario) | ,BLANK-{ N 
R R | Cc 


T 


[.wArT-tenpo attesa bse | ti ; AAA a 


N R 


(SSR) n! PI tentativi Sei 
H N R 


È IMEOUT-fuori tempo sale | |. serc- contatore tentativi sd1e | 


| Differenze dai parametri di procedura 

I LINE-S specifica che la linea è commutata punto-a-punto. 

] LINE-N specifica che la linea è non commutata punto-a-punto. 

Ì LINE-M specifica che il Sistema/36 è una stazione dipendente multipunto. 
I LINE-C specifica che il Sistema/36 è una stazione di controllo indlupunta: 


| LINE-H specifica che la linea utilizza una rete X.21 SHM (in modo scollegamento 
se non attiva). 


| BLANK-N specifica che non viene eseguita né la compressione spazi in bianco né 
il troncamento. 


| BLANK-C specifica che devono essere compressi gli spazi intermedi. 


Ì BLANK-T specifica che devono essere troncati gli spazi. 
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Esempio 
Questo esempio mostra come modificare quanto segue: 
e} numero di linea è 3 
e L'indirizzo tributario per la linea multipunti è ‘TT’ (EBCDIC E3) 
// LOAD $SETCF 
// RUN 


// SETA LNUM-3,LINE-M,ADDR-E3 
// END 


Impostazione dell'ambiente del terminale video (Procedura SET) 


Per ulteriori informazioni vedere la Procedura SET. 


// LOAD $SETCF 

[// IMAGE MEMBER,nome membro cinghia di stampe | 
// RUN 

// SETCF | 1m1ES-1inee per pagine | dead. ,FORMAT-{ MDY 


NO DMY 
YMD 


,DATE-{mmggaa ,LIBRARY-fnome libreria [.RosIzz-ampiezza regione] 
ggmmaa #LIBRARY 
aammgg 0, 


se rai | FORMSNO-mumero di nodulo | 
SYS 


|ID-testo stampa id stampatrice | PE 
N N 
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Differenze dai parametri di procedura 


IMAGE specifica se una specifica OCL IMAGE deve cambiare l'immagine 
della cinghia di stampa. 


YES specifica che l'immagine della cinghia di stampa deve essere modificata. 


NO specifica che l'immagine della cinghia di stampa non deve essere modifi- 
cata. 


Esempio 
Cambiare la cinghia di stampa in BELT64C. 


// LOAD $SETCF 

// IMAGE MEMBER, BELT6EÌC 
// RUN 

// SETCF IMAGE-YFS 

// END 
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Specifica di informazioni testo STAMP (Procedura PRINTKEY) 


Per ulteriori informazioni vedere la Procedura PRINTKEY. 





Pen 
// LOAD $SETCF 
// RUN 
// SETPK [tD-ia stampatrice | I } ,HEADER- fY 
N N 
// END 
Esempio 
Questo esempio mostra come ottenere la stampa di un margine e di un testo fisso 
superiore e come predisporre l'invio dell'emissione stampata alla stampatrice P4. 
/} LOAD $SETCF 
// RUN 
// SETPK ID-PÌ,BORDER-Y,HEADER-Y 
// END 
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PROGRAMMA DI UTILITA’ $SETCP 


Il programma di utilità $SETCP consente di descrivere l'harware di comunicazioni 
installato nel sistema. 


‘Per ulteriori informazioni vedere la Procedura SETCOMM. 


// LOAD $SETCP 
// RUN 


// SET laica >») ,LINE-(N} ERG } eeea(a)| 
è | N N 


[sa] (e) [e] ft] 


| «rMEOUI-sU0ri tempo sale | |.sERo-contatore tentativi sale | | come 6 


fà 
| N 
,X25-fY , LSPEED- | 2 
N ù 
9 
5 
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Differenze dai parametri di procedura 


LINE-N specifica che la linea non è di tipo commutato da punto a punto. 


LINE-S specifica che la linea è di tipo commutato da punto a punto. 
LINE-T specifica che il Sistema/36 è una stazione dipendente multiplo. 
LINE-C specifica che il Sistema/36 è una stazione di controllo multipunto. 
LINE-H specifica che la linea utilizza una rete X.21 SHM (in modo scollegamento 
se non attiva). 
MODEM-6 specifica un tipo di modem IBM 386X o IBM LPDA. 
MODEM-7 specifica un tipo di modem IBM 387X. 
MODEM-N spacifica un tipo di modem non-IBM. 
LSPEED-2 specifica una linea DDSA con una velocità di trasmissione di 2400 bps. Valido 
soltanto con ELCA. 
LSPEED-4 specifica una linea DDSA con una velocità di trasmissione di 4800 bps. Valido 
soltanto con ELCA. 
LSPEED-9 specifica una linea DDSA con una velocità di trasmissione di 9600 bps. Valido 
soltanto con ELCA. 
LSPEED-5 specifica una linea DDSA con una velocità di trasmissione di 56000 bps. Vali- 
do soltanto con ELCA. 
Iaia 
Esempio 
Predisporre la linea di comunicazioni 1 come linea non commutata da punto a 
punto. 
// LOAD $SETCP 
// RUN 
// SET LNUM-1,LINE-N 
/} END 


SET 


PROGRAMMA DI UTILITA’ $SFGR 


Il programma di utilità $SFGR consente di creare, aggiornare, aggiungere o can- 


cellare tracciati video. 


Per ulteriori informazioni vedere la Procedura F 


ORMAT. 


Per creare, aggiungere o aggiornare un membro oggetto tracciato video: 


// LOAD $SFGR 
// RUN 


// LOADMBR NAME-nome membro oggetto PRA { 


// INOUT |INLIB-fmembro origine libreria i 
LIBRARY 


NO 


N 
a sPRINT- ( YES 

e} 
PARTIAL 


/} a SOURCE-nome membro origine |, NUMBER 
PRES 


// END 


e) |") 


OUTLIB-fmembro oggetto libreria 
#LIBRARY 


1 numero di formati } 
1 





Differenze dai parametri di procedura 


Le specifiche CREATE, ADD e UPDATE possono essere ripetute in qualsiasi 
ordine. E’ possibile indicare un massimo di 32 specifiche in qualsiasi combinazio- 
ne. Per esempio, è possibile indicare 16 specifiche CREATE, 8 specifiche 
UPDATE e 8 specifiche ADD con un solo caricamento ed una sola esecuzione del 
programma di utilità $SFGR. 


SSP specifica se il membro oggetto deve essere un membro SSP. YES specifica 
che il membro oggetto che viene creato è un membro SSP e non può essere 
rimosso usando la procedura REMOVE. NO specifica che il membro oggetto 
è un membro dell'utente e può essere rimosso usando la procedura REMOVE. 
Se non viene specificato il parametro SSP, si presume NO. 


Per cancellare un tracciato da un membro oggetto tracciato video: 


LOAD $SFGR 
RUN 
LOADMBR NAME-nome membro oggetto 


INOUT OUTLIB-membro oggetto libreria | 


DELETE FORMAT-nome formato video 
END 





La specifica DELETE può essere ripetuta. E’ possibile indicare un massimo di 32 
specifiche. 


Esempio 


Creare un nuovo membro oggetto tracciato video denominato FORMAT2 nella 
libreria denominata MYLIB. Per generare il membro oggetto devono essere usati 
tre membri origine tracciato video. | tre membri.origine sono denominati DISP1, 
DISP2 e DISP3; tutti sono memorizzati in una libreria denominata MYLIB. 


// LOAD $SFCR 

// RUN 

// LOADMBR NAME-FORMAT2,REPLACE-YES 

// INOUT INLIB-MYLIB,OUTLIB-MYLIB,PRINT-PARTIAL 
// CREATE SOURCE-DISP1,NUMBER-3 

// CREATE SOURCE-DISP2, NUMBER-l 

// CREATE SOURCE-DISP3, NUMBER-2 

// END 
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| PROGRAMMA DIUTILITÀ $SINCT 


Il programma di utilità $SINCT consente di ripristinare l'indirizzario risorse di rete 

a (#NRD.FLE) come un file di sistema. Per maggiori informazioni su come ripristinare 
l’indirizzario risorse di rete da minidisco o nastro su disco, vedere il programma di 
utilità $COPY. 


[ Per maggiori informazioni vedere la procedura RESTNRD. 


// RUN 


| // LOAD $SINCT 
// END 





| PROGRAMMA DI UTILITÀ $SINDL 


Il programma di utilità $SINDL consente di rimuovere l’indirizzario risorse di rete 
{($NRD.FLE) da disco. 


| Per maggiori informazioni vedere la procedura DELNRD. 


// MEMBER USER1-#SI#M1,USER2-#SI#M2 
// LOAD $SINDL 

// RUN 

// END 





| PROGRAMMA DI UTILITÀ $SINR 


| Il programma di utilità $SINR consente di creare o di preparare per la stampa l’indi- 
rizzario risorse di rete (#NRD.FLE). 


| Per maggiori informazioni vedere la procedura EDITNRD. 


// MEMBER USER1-#SI#M1,USER2-#SI1#M2 
// LOAD $SINR 
// WORKSTN UNIT-?WS?,RESTORE-YES 


// RUN 
// END 





780.1 


| PROGRAMMA DIUTILITÀ $SVCASRV 


| {l programma di utilità $SVCASRV consente all'operatore di sistema di creare, mo- 





dificare o annullare un cache su disco. = 
| Per maggiori informazioni vedere la procedura CACHE. = 
// LOAD $SVCASRV 
// RUN 
// CACHE | FUNC-| ALTER [szbampieza| [PACESIZE piena paci] 
START 
STOP 
| Esempio 
| Questo esempio mostra come avviare un cache di 64 kb con ampiezza pagina di 2kb. 
/ LOAD $SVCASRV 
// RUN 
! CACHE FUNC-START,SIZE-64,PAGESIZE-2 
// END 
e 
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PROGRAMMA DI UTILITA’ $TCOPY 
Il programma di utilità $TCOPY consente di: 
e Copiare dati su o da nastro 


e Listare file su nastro 


Copia di dati da o su nastro (Procedura TAPECOPY) 
Per ulteriori informazioni vedere la Procedura TAPECOPY. 


Per trasferire i dati da disco a nastro o da nastro a disco: 


LOAD $TCOPY 
FILE NAME-COPYIN,UNIT-f F1),LABEL-dell'identificazione file 


FILE NAME-COPYO,UNIT-{[F1|,LABEL-alla identificazione file 
TI 
T2 


RUN 


TRANSFER i : 2A oÌ N [KexLEN-vatore |, [KEYLOC-varore] 


\ No NO 


END 
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Per visualizzare i contenuti del file su nastro: 


// LOAD $TCOPY 





// FILE NAME-COPYIN,UNIT-{F1|},LABEL-dall'identificazione file 
fp. 
T2 








// RUN 


// DISPLAY [FROM-valore | ,[To-valore 


// END 





Sono presentati soltanto alcuni dei parametri per la specifica OCL FILE. Per ul. 
teriori informazioni sulla specifica OCL FILE, vedere la SPecifica OCL FILE (per 
i file su disco) e la Specifica OCL FILE (per i file su nastro). 


Esempio 1 


Questo esempio prende un file su disco denominato FILE1 e lo copia su un file 
su nastro denominato FILE2, Il nastro è montato sull'unità nastro 1. 


// LOAD $TCOPY 

// FILE NAME-COPYIN,UNIT-F1.LABEL-FILEl 
// FILE NAME-COPYO,UNIT-T1,LABEL-FILE2 
// RUN 

// TRANSFER ADD-NO,CHKLAST-YES 

// END 


Esempio 2 


Questo esempio prende un file da nastro montato sull'unità nastro 1 denominato 
SHOW e ne visualizza i primi 100 record. 


// LOAD $TCOPY 

// FILE NAME-COPYIN,UNIT-T1,LABEL-SHOW 
// RUN 

// DISPLAY FROM-1,TO-100 

// END 
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PROGRAMMA DI UTILITA’ $TINIT 
Il programma di utilità $TINIT consente di inizializzare un nastro. 


Per ulteriori informazioni su ciò che questa procedura fa, vedere la Procedura 
TAPEINIT. 


// LOAD $TINIT 

// RUN 

// VOL UNIT-fT1\,REEL-{STDLABEL [,vonmp-ia volune | s TYPE- (CHECK 
T2 (SL) = CLEAR 


NONLABEL 
(NL) 


UNLOAD 


[-1D-caratteri] IA } “Aa 


NOERASE 


// END 





Esempio 


Ridenominare un nastro in modo che il nuovo ID di volume sia VOL0OO1 e l'id 
dell'utente sia YOURNAME. Non controllare i file non scaduti. Cancellare il 

T- resto del nastro. Il nastro è montato suli'unità nastro 1 e deve essere riavvolto 
e scaricato dopo che è stato preparato. 


// LOAD $TINIT 

// RUN 

// VOL UNIT-T1,REEL,STDLABEL,VOLID-VOLOO1,TYPE-CLEAR, 
ID-YOURNAME,SECURITY-ERASE, END-UNLOAD 

/ END 
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PROGRAMMA DI UTILITÀ $STMSERV 
Il programma di utilità $TMSERV permette di: 


Copiare un membro di cartella su minidisco, nastro o nastro a cassetta (Proce- 
dura ARCHIVE) 


Copiare una cartella su minidisco, nastro o nastro a cassetta (Procedura 
SAVEFLDR) 


Listare il contenuto di un membro di cartella che è stato salvato su minidisco, 
nastro o nastro a cassetta (Procedura LISTFILE) 


Riorganizzare una cartella (Procedura ALOCFLDR e CONDENSE) 


Ripristinare un membro di cartella da minidisco, nastro o nastro a cassetta (Pro- 
cedura RETRIEVE) 


Ripristinare una cartella da minidisco, nastro o nastro a cassetta (Procedura 
RESTFLDR) 


Copiare un membro di cartella su minidisco, nastro o nastro a cassetta 
{Procedura ARCHIVE) 


Vedere la Procedura ARCHIVE per ulteriori informazioni. 


// LOAD $TMSERV 
// FILE NAME-COPYO,UNIT-({1I1},LABEL-f file name 
T1 member name 


// RUN 


T2 


// ARCHIVE FOLDER-folder name,MEMTYPE-DOCUMENT, 
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NO TEXT 


ui 3). ; uni: ; 


MEMBER 


[sesnnne-nember nane| 


Sono presentati soltanto alcuni parametri per la specifica OCL FILE. Per ulteriori infor- 
mazioni sulla specifica OCL FILE, vedere la specifica OCL FILE (per i file su minidisco) e 





la specifica OCL FILE (per i file su nastro). 


pr 


Copiare una cartella su minidisco, nastro o nastro a cassetta (Procedura 
SAVEFLDR) 


Vedere la Procedura SAVEFLDA per ulteriori informazioni. 


LOAD $TMSERV 
FILE NAME-COPYO, E I i} LABEL- folder name 


TI 
T2 


SAVEFLDR sani 
NO 





Sono presentati soltanto alcuni parametri per la specifica OCL FILE. Per ulteriori 
informazioni sulla specifica OCL FILE, vedere la specifica OCL FILE (per i file su 
minidisco) e la specifica OCL FILE (per i file su nastro). 


| Listare il contenuto di un membro di cartella archiviato (Procedura LISTFILE) 


Vedere la Procedura LISTFILE per ulteriori informazioni. 


LOAD $TMSERV 

FILE NAME-COPYO,UNIT-[I1}|,LABEL-file name 
TI 
T2 


RUN 
LISTARCH 
END 





Sono presentati soltanto alcuni parametri per ia specifica OCL FILE. Per ulteriori 
informazioni sulla specifica OCL FILE, vedere la specifica OCL FILE (peri file su 
minidisco) e la specifica OCL FILE (per i file su nastro). 


783.2 


Riorganizzare una cartella (Procedura ALOCFLDR e CONDENSE) 
Vedere la Procedura ALOCFLDA e la Procedura CONDENSE per ulteriori informazioni. 


Per riorganizzare una cartella e, facoltativamente, incrementare o decrementare l'am- 
piezza della cartella (Procedura ALOCFLDR): 


LOAD $TMSERV 
RUN 


INCR 


RORGFLDR FOLDER-folder name, maia 


END 





Per riorganizzare una cartella e ridurla più piccola possibile (Procedura CONDENSE): 


LOAD $TMSERV 
RUN 


RORGFLDR FOLDER-folder name, CHANGE-MIN 
END 





783.3 





Ripristinare un membro di cartella da minidisco, nastro o nastro a casset- 
ta (Procedura RETRIEVE) 


Vedere la Procedura RETRIEVE per ulteriori informazioni. 


// LOAD $TMSERV 

// FILE NAME-COPYIN,UNIT-|I1}|,LABEL-file name 
TI 
T2 


// RUN 
// RETRIEVE FOLDER-folder name, 


[remo member name | 


Sono riportati solo alcuni dei parametri della specifica OCL FILE. Per ulteriori informazio- 
ni sulla specifica OCL FILE, vedere la specifica OCL FILE (per i file su minidisco) e la spe- 
cifica OCL FILE (per i file su nastro). 


Ripristinare una cartella da minidisco, nastro o nastro a cassetta (Proce- 
dura RESTFLDR) 


Vedere la Procedura RESTFLDA per ulteriori informazioni. 


// LOAD $TMSERV 

// FILE NAME-COPYIN,UNIT-{1I1),LABEL-folder name 
TI 
T2 


// RUN 


AQ 
// RESTFLDR |DISKLOC-< A3 


Sono riportati solo alcuni dei parametri della specifica OCL FILE. Per ulteriori informazio- 
ni sulla specifica OCL FILE, vedere la specifica OCL FILE (per i file su minidisco) e la spe- 
cifica OCL FILE (per i file su nastro). 
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PROGRAMMA DI UTILITA’ $UASC 


Il programma di utilità $UASC consente di visualizzare o stampare entrate copia- 
te da un file in spool. dA 


Per ulteriori informazioni vedere la Procedura COPYPRT. 


// LOAD $UASC 
// FILE NAME-nome file ,DISP-SHR 


// RUN 





Esempio 


Visualizzare le entrate nel file in spool che sono state copiate in un file denomi- 
nato SPOOLENT. 


// LOAD $UASC 
// FILE NAME-SPOOLENT 
// RUN 


PROGRAMMA DI UTILITA’ $UASF 


ll programma di utilità $UASF consente di copiare su un file su disco entrate dal 
file in spool. 


Per ulteriori informazioni vedere la Procedura COPYPRT. 


// LOAD $UASF 
// RUN 


id spool CANCEL 
FXKxxx 
SYSTEM 


// SPOOL SPCOLID-{ ALL [.x4ME-nome file] i 


«RETAIN-Y I. 


Differenze dei parametri di procedura 


RETAIN classifica il file come residente (T) di, lavoro (J), o temporaneo (S) quando è 
copiato. Se non è specificato nessun parametro è assunto T. 


Esempio 1 


Copiare tutte le entrate del file di spool in un file denominato SPFILE. Le speci- 
fiche son immesse dalla console di sistema a cura dell'operatore del sistema. 


// LOAD $UAS 

// RUN 

// SPOOL SPOOLID-SYSTEM,NAME-SPFILE 
// END 


Esempio 2 


Copiare tutte le entrate del file di spool con moduli numero 0017 in un file de- 
nominato F0017W3. Le specifiche sono immesse dal terminale video W3. 


// LOAD $UASF 

// RUN 

// SPOOL SPOOLID-F0017,NAME-F0017W3 
// END 
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PROGRAMMA DI UTILITA’ $XNLM 


Il programma di utilità $XNLM consente di creare o aggiornare liste di numeri di 
collegamento per una rete di dati pubblica X.21. 


Per ulteriori informazioni vedere la Procedura DEFINX21. 


//] MEMBER PROGRAMI-#XN#M1,PROGRAM2-#XN#M2 


// LOAD $XNLM 
// RUN 





Esempio 
Per creare un elenco di chiamate, occorre immettere: 


// MEMBER PROGRAM1-#XN#M1, PROGRAM2-#XN#M2 
// LOAD $XNIM 
// RUN 


| PROGRAMMA DI UTILITÀ $ XNSH 


Il programma di utilità $XNSH consente di creare, modificare, stampare o cancella- 
re una configurazione X.21 SHM (in modo scollegamento se non attiva). 


| Per maggiori informazioni vedere ia procedura DEFINX21. 


// MEMBER PROGRAM1-#XN#M1,PROGRAM2-#XN#M2 
// LOAD $XNSH 


// RUN 





| Esempio 


| Per creare una configurazione linea X.21 SHM (in modo scollegamento se non atti- 
va) si dovrà immettere: 


// MEMBER PROGRAM.-1 # XN #M1,PROGRAM2-# XN # M2 
// LOAD # XNSH 
// RUN 


786 


PROGRAMMA DI UTILITA’ #GCFR 


Il programma di utilità #GCFR consente di registrare o cancellare un dispositivo 
dell'utente disponibile su una rete di dati pubblici X.21. 


Per ulteriori informazioni vedere la Procedura REQUESTX. 


[ seu nome membro,S, #GC@REQX, nome libreria | 


// LOAD #GCFR 


// RUN 
// REQX SOURCE-nome membro ,LIBRARY-nome libreria 


// END 


Esempio 1 
Avviare la procedura REQUESTX che quindi chiederà le richieste. 


// LOAD #GCFR 
// RUN 
// END 


Esempio 2 


Avviare la procedura REQUESTX che quindi elaborerà il membro origine di li- 


breria REQ dalla libreria corrente (denominato MYLIB). 


// LOAD #GCFR 

// RUN 

// REQX SOURCE-REQ,LIBRARY-MYLIB 
// END 
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Appendice B. Conversioni 


CONVERSIONE DA ESADECIMALE A DECIMALE 


E’ possibile usare la tabella che segue per convertite un numero decimale in un 
numero esadecimale oppure per convertire un numero esadecimale in un numero 
decimale. Seguono esempi del modo in cui usare la tabella. 





Posizione 4 Posizione 3 Posizione 2 Posizione 1 
Hex Dec Hex Dec Hex Dec 





0 
1 
2 
3 
4 
5 
6 
7 
8 
9 





MIMO pDOONDOUIAWN-O 
MMV0O0NpPOONOUNUSWN-O 
MIM0O0FCpO0ONOUOSWN-O 
Sino iaia 





Esempio di conversione da esadecimale a decimale 
Per trovare il valore decimale del valore esadecimale 1FA, si troverà che: 
i In posizione 3, esadecimale 1 equivale a decimale 256 
2. In posizione 2, esadecimale F equivale a desio 240 
3. In posizione 1, esadecimale A equivale a decimale 10 


Sommando questi tre numeri decimali, si ha il valore decimale di esadecimale 
1FA. 


256 + 240 + 10 = 506. 


Posizione 4 | Posizione 3 Posizione 2 Posizione 1 
Hex Dec Hex Dec Hex Dec Hex Dec 
0 0 1 F 240 A 10 
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Esempio di conversione da decimale a esadecimale 


Per trovare il valore esadecimale del decimale 538, si troverà che: 


1. H successivo numero decimale più basso nella tabella è 512 in posizione 3. 
Ciò è uguale a esadecimale 2. 


2. Occorre quindi sottrarre 512 da 538 e usare la differenza per trovare il suc- 
cessivo valore esadecimale. 


538 - 512 = 26 


3. II successivo numero più basso nella tabella da 26 è 16 in posizione 2. Ciò 
è uguale a esadecimale 1. 


4. Sottrarre quindi 16 da 26 e usare la differenza per trovare il successivo valo- 
re esadecimale. 


26 — 16 = 10 


5. I 10 rimanente si trova nella posizione 1 della tabella. Esso è uguale a esa- 
decimale A. 


E' possibile quindi combinare le posizioni dei valori esadecimali. Pertanto, il deci- 
male 538 equivale a esadecimale 21A. 


TO ORO CS LOSE CSO DE) 








CONVERSIONE DA RECORD A BLOCCHI PER FILE SU DISCO 
Questa sezione aiuta a stabilire quanti blocchi usa un file su disco quando il file 
è allocato per numero di record. Un biocco su disco contiene 10 settori. Ciascun 
settore contiene 256 byte. 

Determinazione del numero di blocchi in un file diretto o sequenziale 


Per determinare il numero di blocchi in un file diretto o sequenziale: 


1. Moltiplicare il. numero dei record per la lunghezza record per determinare il 
numero di byte nella porzione dati del file. 


(numero di record) x (lunghezza record) = (numero di byte) 


2. Dividere il numero di byte per il numero dei byte per blocco. Un blocco 
contiene 2560 byte. 


(numero di byte) / 2560 = (numero di blocchi) 


Artotondare il numero di blocchi al successivo numero intero. 


Esempio 


Un file su disco sequenziale è stato allocato con 200 record. La lunghezza record 
del file è 15. 


Coen 


1. 


2. 


ll numero di byte nel file è 3000: 
200 x 15 = 3000 
il numero di blocchi usati dal file è 2: 


3000 / 2560 = 1.1 (arrotondamento) 
2 (munéro di blocchi) 


Determinazione del numero di blocchi in un file a indice 


Per determinare il numero di blocchi in un file a indice occorre per prima cosa 
determinare il numero dei settori del disco in un file a indice: 


1 


Moltiplicare il numero di record nel file per la lunghezza record del file per 
determinare il numero dei byte nel file. 


(numero di record) x (lunghezza record) = (numero di byte) 
Dividere il numero di byte richiesti per l’area di dati per il numero di byte 
per settore del disco per determinare il numero di settori di dati usati dal fi- 
le. Un settore del disco contiene 256 byte. Se il numero contiene una frazio- 


ne, arrotondare il numero al numero intero successivo. 


(numero di byte) / 256 = (numero dei settori di dati) 
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Successivamente occorre determinare il numero dei settori del disco usati dall’in- 
dice del file a indice: 


3. Aggiungere la lunghezza del campo chiave al numero 3 per determinare la 
lunghezza di ciascuna entrata di indice. L'aggiunta di 3 byte è per il numero 
relativo di record di 3 byte che è associato a ciascuna chiave nell’indice. 


(lunghezza del campo chiave) + 3 = (lunghezza entrata indice) 


4. Dividere il numero dei byte in un settore (256) per la lunghezza dell'entrata 
di indice per determinare il numero delle entrate di indice per settore. Se il 
numero ha una frazione, usare soltanto la parte intera. 


256 / (lunghezza entrata indice) = { numero delle entrate 
di indice per settore 


5. Dividere il numero dei record nel file a indice per il numero di entrate di in- 

dice per settore per determinare il numero di settori dell'indice. Se il numero 

| contiene una frazione, arrotondare il numero al successivo intero. Aggiungere 
quindi 1 al risultato. 


numero di | / {numero delle entrate |\+ 1 = {numero settori 
record di indice per settore dell'indice 


Determinare ora il numero totale dei blocchi usati da un file a indice: 


6. Aggiungere il numero dei settori di dati dalla fase 2 al numero di settori del- 
l'indice per determinare il numero totale dei settori nel file. 


numero dei settori) + { numero dei settori) = / numero totale 
di dati dell'indice dei settori 


7. Dividere il numero totale dei settori per il numero dei settori per blocco per 
determinare il numero totale dei blocchi per il file, Un blocco contiene 10 
settori. Se c'è un resto, arrotondare il numero al numero intero successivo. 


(numero totale dei settori) / 10 = (numero dei DIE) 
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Pon 


ST 


Esempio 


Un file a indice è stato allocato con 200 record. La lunghezza record del file è di 
15; ia lunghezza del campo chiavi è 12. 


Il numero dei settori di dati nel file è 12. 


200 x 15 = 3000 (numero di caratteri) 


3000 / 256 = 11.7 (arrotondare) Ì 
12 (numero dei settori di dati) 


Il numero dei settori dell'indice è 13. 


12 + 3 = 15 (lunghezza dell'entrata di indice) 
256 / 15 


17.1 (trascurare la parte frazionaria) 
7 (numero delle entrate di indice per settore) 


H 


11.8 (arrotondare) 
12 
12+1= 13 (aggiunta di 1) 
13 (numero di settori dell'indice) 


200 / 17 


Il numero totale di blocchi è 3. 


12 + 13 = 25 (numero totale di settori nel file) 


25 / 10 


2.5 (arrotondare) 
3 (numero di blocchi) 
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Appendice C. Procedure di sussidio di servizio 


Questa appendice descrive le procedure di sussidio di servizio del Sistema/36. 
Non occorrerà normalmente eseguire queste procedure; comunque può essere 
chiesto di eseguirne alcune per effettuare la diagnostica e la correzione dei pro- 
blemi. 


Per informazioni sulla diagnostica, vedere il manuale Diagnostica di Sistema. Per 
ulteriori informazioni su queste procedure di sussidio di servizio, vedere il manua- 
le Program Problem Diagnosis and Diagnostic Aids. 
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PROCEDURA APAR 


La procedura APAR raccoglie informazioni diagnostiche che aiutano il personale di servi- 
zio IBM a correggere problemi di programmazione che potrebbero verificarsi nel sistema. 
La procedura APAR crea uno o più file su minidisco o nastro che contengono quanto se- 
gue: 


e File della memoria di controllo. 
e File di copia della memoria dell'unità di controllo di emissione/immissione. 


e L'area di lavoro del sistema {se non si sta eseguendo la procedura APAR du- 
rante l’IPL dopo una copia della memoria di sistema), compreso: 


— La configurazione del sistema 

— L'indice del volume del disco {VTOC) 
— L'indice #SYSWORK 

— L'area di lavoro di traccia 

— L'area di lavoro di riservatezza 

— L'area di lavoro PTF 

— “IH VTOC del minidisco 

—  L'identificazione di volume 

—  L'avviamento IPL 


e Registrazioni di correzioni temporanee ai programmi della libreria dei pro- 
grammi su licenza IBM (PTF). 


e Le registrazioni di servizio di sistema. 


e | file di traccia dei dischi. Se non si sta eseguendo la procedura APAR du- 
rante l'IPL e non si vuole copiare una stampa della funzione, viene presenta- 
to uno schermo di richiesta dei file di traccia dal quale è possibile scegliere 
un massimo di 16 file di traccia da copiare. 


e Tabelle di microcodifica. 

e Tabelle di registrazione degli errori (ERAP). 
e File di stampa della funzione (facoltativi). 
e File storico, cronologico (facoltativo). 

e File di stampa differita (facoltativo). 

e Coda dei lavori (facoltativo). 

e File messaggi (facoltativo) 


® File dati livello prodotto 


Inoltre, la procedura APAR può copiare un membro oggetto specificato su un file su mi- 
nidisco o nastro denominato APARLOAD, un membro origine specificato su un file su 
‘minidisco denominato APARSRCE e un membro di procedura specificato su un file su 
minidisco o nastro denominato APARPROC. Quando inizia l'esecuzione della procedura 
APAR, compare uno schermo dal quale è possibile scegliere le aree di dati del sistema, il 
file storico, cronologico, il file di stampa differita e la coda dei lavori da copiare sul minidi- 
sco o nastro. 


La maggior parte delle aree di dati copiate su minidisco o nastro dalla procedura 
APAR possono essere visualizzate usando la procedura DUMP oppure è possibile 


includere i minidischi o i nastri con un Authorized Program Analysis Report (APAR). 


La procedura APAR può essere avviata durante l’IPL dopo aver eseguito una co- 
pia della memoria del sistema. 


2 


id volume, [nome membro oggetto , [none membro origine] 3 


[nome membro di procedura | s| nome file di copia della memoria), 
0 


2 
s| AUTO 
NOAUTO 





I parametri 6 e 7 sono ignorati per i sistemi senza moduli a minidischi con cari- 
catore. 


id volume specifica l'ID di volume di uno o più minidischi o nastri destinati a ricevere le 
aree di dati del sistema. 


nome membro oggetto specifica il membro oggetto contenente il programma che ha 
provocato la comparsa dell'errore di programma. Il membro oggetto viene inserito 
in un file su minidisco o nastro denominato APARLOAD. 


nome membro origine specifica il membro origine dal quale è stato creato il program- 
ma. Il membro origine viene inserito in un file su minidisco o nastro denominato 


APASRCE. 


nome membro di procedura specifica ii membro di procedura dal quale è stato richia- 
mato il programma. H membro di procedura viene inserito in un file su minidisco o 


nastro contrassegnato APARPROC. 


nome file di copia della memoria specifica il file creato dalla procedura DUMP o da 
una stampa di funzione. Zero specifica che deve essere copiato il file di copia della 
memoria più recente. Se non viene specificato un nome file e la procedura APAR 
viene eseguita da un'unità video, viene visualizzato lo stato di tutti i file di copia del- 
la memoria ed è possibile sceglierne uno (o nessuno) da copiare. Se non viene spe- 
cificato un nome file e la procedura APAR non viene eseguita da un'unità video non 
viene copiato alcun file di copia delia memoria su minidisco o nastro. 


I file di copia della memoria sono denominati #DUMP.nn sul disco dove nn 
è un numero da 00 a 99. 


S1, $2 o S3 specifica l'alimentatore del minidisco contenente il primo minidisco 
da usare. Se non viene specificato alcun parametro, si presume S1. 


M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidi- 
sco da elaborare. M1 indica il primo caricatore e M2 indica il secondo cari- 
catore. nn è un numero da 01 a 10 che identifica la locazione del minidisco 
nei caricatore. Specificare M1 equivale a specificare M1.01; specificare M2 


equivale a specificare M2.01. È 
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AUTO specifica quanto segue: 


e Se viene specificato S1, S2 o $3, è possibile usare tutti e tre i singoli 
alimentatori (S1, S$2 e S3). L'elaborazione inizia con il minidisco nel- 
l'alimentatore specificato e continua fino al minidisco nell’alimentatore 
S3. Se occorrono altri minidischi, viene visualizzato un messaggio e 
l'operatore deve inserire i successivi minidischi. L'elaborazione riprende 
col minidisco nell'alimentatore S1. 


e Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli 
alimentatori di caricatore (M1 e M2). L'elaborazione inizia con il mini- 
disco nella locazione specificata e continua fino al minidisco nella loca- 
zione M2.10. Se occorrono altri minidischi, viene visualizzato un mes- 
saggio e l'operatore quindi inserisce i successivi caricatori. L'elaborazione 
riprende alla locazione M1.01. 


e Seè specificato T1 o T2, quando la bobina sull'unità a nastri è terminata, 
il sistema passerà all'altra unità a nastri, se disponibile, affinchè l’elabora- 
zione possa continuare (T1 a T2 o T2 a T1). Se l’altra unità non è dispo- 
nibile sarà usata la stessa unità dove è montato il nastro. Sarà fornita una 
richiesta per verificare che ia bobina montata sia quella richiesta dall’ela- 
borazione. 


Se non viene specificato alcun parametro, si assume AUTO. 
NOAUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, può essere usato soltanto l’alimentato- 
re specificato, Se occorrono altri minidischi, viene visualizzato un mes- 
saggio e l'operatore deve inserire il successivo minidisco nell'alimentato- 
re specificato. 


e Se viene specificato M1.nn o M2.nn, può essere usato soltanto il carica- 
tore specificato. L'elaborazione inizia con il minidisco nella locazione 
specificata e continua fino all'ultimo minidisco nel caricatore. Se sono 
necessari altri minidischi, viene visualizzato un messaggio e l'operatore 
deve inserire il successivo caricatore nell’alimentatore che viene usato. 
L'elaborazione riprende alla prima locazione nel caricatore. 


e SeT1oT2 è specificato, solo l'unità a nastri specificata sarà usata per 
tutti i volumi di nastro. 


11 specifica che le informazioni collezionate dalla procedura APAR devono essere 
copiate su nastro. Se non è specificato nessun parametro, è assunto 11. 


T1 o T2 specifica che le informazioni collezionate dalla procedura APAR devono 
essere copiate su nastro. T1 indica che il nastro è montato sull'unità 1. 
T2 indica che il nastro è montato sull’unità 2. 


Esempio 


L'esempio che segue mostra come immettere la procedura APAR per copiare le 
aree di dati di sistema su uno o più minidischi. E' stato creato un file denomina- 
to #DUMP.03 da una stampa della funzione. | minidischi hanno ID di volume di 
VOL0O01 e sono posti negli alimentatori $1, S2 e S3 del modulo per minidi- 
schi. Deve essere anche copiato il membro oggetto denominato PROGRAM. 


APAR VOLOO1,PROGRAM, , ,#DUMP. 03 


PROCEDURA DFA 


La procedura DFA (analisi del file di copia della memoria) richiama informazioni selezio- 
nate da un file di copia della memoria, organizza le informazioni e le visualizza o le stam- 
pa. La procedura DFA può anche essere usata per organizzare file di copia della memoria 
copiati su minidischi o nastri dalla procedura APAR. 


La procedura DFA può essere eseguita da qualsiasi unità video. Se è attiva la ri 
servatezza mediante parola d'ordine, l'operatore deve avere un'autorità di sussidio 
di servizio per poter eseguire la procedura DFA. 


PRINTER s|F1},|nome file|,{Sl , (AUTO 
id stampatrice Il| |O s2 NOAUTO 


CRT TI 53 
T2 Ml.nn 
M2.nn 





I parametri 4 e 5 sono ignorati per i sistemi senza moduli e minidischi con cari- 
catori. 


PRINTER specifica che l’emissione deve essere stampata sulla stampatrice di ses- 
sione assegnata all'unità video che esegue la procedura DFA. Se non è speci- 
ficato alcun parametro, si presume PRINTER. 


id stampatrice specifica l'ID di terminale della stampatrice che deve stampare l’e- 
missione. 


CRT specifica che l'emissione deve essere visualizzata sull'unità video che esegue 
la procedura DFA. F1 specifica che l'immissione alla procedura DFA sarà un 
file di copia della memoria su disco. Se non è specificato alcun parametro, 
si presume F1. 


11 specifica che l'immissione alla procedura DFA sarà un file di copia della me- 
moria su minidisco che è stato creato dalla procedura APAR, da una copia 
della memoria di sistema o da una copia deila memoria dell'attività. 


T1 o T2 specifica che l'immissione alla procedura DFA sarà un file su nastro che è stato 
creato dalla procedura APAR, da una copia della memoria di sistema o da una copia 
della memoria del lavoro. T1 indica che il nastro è montato sull'unità 1. T2 indica 
che il nastro è montato sull'unità 2. 


nome file specifica il file da elaborare dalla procedura DFA. Se viene specificato 
F1, questo file deve essere stato creato da una stampa della funzione, dalla 
procedura DUMP o da una copia della memoria di sistema. | file di copia 
della memoria sono denominati #DUMP.nn su disco, dove nn è un numero 
da 00 a 99. 


Se viene specificato 11, il file deve essere un file creato dalla procedura 
APAR da una copia della memoria di sistema o da una stampa della funzio- 
ne. La procedura DFA per prima cosa copia il file APAR sul disco. Se il 
nome file specificato esiste già sul disco come file di copia della memoria, 
viene sostituito; se il file su disco non è un file di copia della memoria, viene 
visualizzato un messaggio ed è possibile sostituirlo o cancellare la procedura. 


0: Se viene specificato F1, 0 (zero) indica che la procedura DFA deve usare il 
file di copia della memoria più recente, Se si inserisce la procedura DFA nel 
la coda dei lavori, si presume O se non viene specificato alcun nome file. 


Se è specificato 11, 0 indica che il file APARFILE deve essere copiato da un 
file su minidisco in un file su disco. Questo file su disco automaticamente 
viene cancellato quando la procedura DFA termina. 799 
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S1, S2 o S3 specifica l'alimentatore del minidisco contenente il primo minidisco 


da usare. Se non viene specificato alcun parametro, si presume S1. 


M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidi- 


sco da elaborare. M1 indica il primo caricatore e M2 indica il secondo cari- 
catore. nn è un numero da 01 a 10 che identifica ia locazione del minidisco 
nel caricatore. Specificare M1 equivale a specificare M1.01; specificare M2 
equivale a specificare M2.01. 


AUTO specifica quanto segue: 


Se viene specificato S1, S2 o S3, è possibile usare tutti e tre i singoli 
alimentatori (S1, S2 e S3). L'elaborazione inizia con il minidisco nel- 
l'alimentatore specificato e continua fino al minidisco nell’alimentatore 
S3. Se occorrono altri minidischi, viene visualizzato un messaggio e 
l'operatore deve inserire i successivi minidischi. L'elaborazione riprende 
col minidisco nell’alimentatore S1. 


Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli 
alimentatori di caricatore (M1 e M2). L'elaborazione inizia con il mini- 
disco nella locazione specificata e continua fino al minidisco nella loca- 
zione M2.10. Se occorrono altri minidischi, viene visualizzato un mes- 
saggio e l'operatore quindi inserisce i successivi caricatori. L'elaborazione 
riprende alla locazione M1.01. 


Se è specificato T1 o T2, quando la bobina sull'unità a nastri è terminata, 
il sistema passerà sull'altra unità a nastri, se disponibile, affinchè l’elabo- 
razione possa continuare (T1 a T2 o T2 a T1). Se l’altra unità non è di- 
sponibile sarà usata la stessa unità dove è montato il nastro. Sarà fornita 
una richiesta per verificare che la bobina montata sia quella richiesta dal- 
l'elaborazione. 


Se non viene specificato alcuni parametro, si assume AUTO. 


NOAUTO specifica quanto segue: 


Esempio 


Se viene specificato S1, S2 o S3, può essere usato soltanto l’alimentato- 
re specificato. Se occorrono altri minidischi, viene visualizzato un mes- 
saggio e l'operatore deve inserire il successivo minidisco nell’alimentato- 
re specificato. 


Se viene specificato Mi.nn o M2.nn, può essere usato soltanto il carica- 
tore specificato. L'elaborazione inizia con il minidisco nella locazione 
specificata e continua fino all'ultimo minidisco nel caricatore. Se sono 
necessari altri minidischi, viene visualizzato un messaggio e l'operatore 
deve inserire il successivo caricatore nell'alimentatore che viene usato. 
L'elaborazione riprende alla prima locazione nel caricatore. 


Se è specificato T1 o T2, sarà usata solo l’unità a nastri specificata per tutti i volumi. 


Per organizzare e stampare informazioni nel file di copia della memoria su disco 
più recente: 


DFA ,,0 
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PROCEDURA DUMP 


La procedura DUMP stampa o visualizza una qualsiasi delle aree seguenti da disco o da 
un minidisco o nastro creati dalla procedura APAR: 


File di stampa della funzione 
File di copia della memoria di sistema 
File di copia della memoria di controllo 
File di copia della memoria dell'unità di controllo di immissione/emissione 
File di traccia del disco 
Registrazione di PTF in libreria 
VTOC del disco (indice) 
File di stampa differita 
Area di lavoro della funzione 
Coda dei lavori di immissione 
Tabelle di microcodifica 
Registrazioni di servizio del sistema 
| File dati livello prodotto 


La procedura DUMP può anche stampare o visualizzare settori selezionati dal disco 
o dal minidisco e può stampare blocchi selezionati da un nastro o nastro a cassetta. 


La procedura DUMP può essere eseguita da qualsiasi unità video. Se è attiva la ri- 
servatezza mediante parola d'ordine, alcune funzioni della procedura DUMP sono 
limitate agli operatori che hanno autorità di sussidio di servizio. Per ulteriori in- 
formazioni sull’autorità di sussidio di servizio, vedere il manuale Guida alla Riser- 
vatezza del sistema. 


MAIN , | PRINTER , {Fl |, [nome file ; , {AUTO 
CONTROL CRT Il nome libreria NOAUTO 
DISK id stampatrice TI 0 

IOC | T2 

JOBQ 

MCODE 

PLD 


PIF 
SERVLOG 
SPOOL 
STATUS 
TAPE 
TRACE 
TWA 
VTOC 
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MAIN specifica che devono essere listate opzioni selezionate di un file di copia 
della memoria di sistema o di stampa della funzione. Se è attiva la riservatez- 
za mediante parola d'ordine, l'operatore deve avere autorità di sussidio di ser- 
vizio per poter usare DUMP MAIN. 


Se le informazioni sono visualizzate, la procedura DUMP visualizza quanto 
segue: 


Un sommario della copia della memoria 
Il primo segmento della memoria centrale 


L'indirizzo del blocco di controllo funzione e il blocco di richiesta per la 
funzione terminata anorma!lmente 


L'ultima serie di valori memorizzati nei registri per la funzione terminata 
anormalmente 


E’ possibile usare i tasti di scorrimento per esaminare i dati. E’ inoltre possi- 
bile specificare un diverso indirizzo di memoria o di tipo di memoria. | tipi 
di memoria possibili sono: 


M 


Vv 


X 


Cc 


F 


Memoria centrale non convertita 
Memoria virtuale non convertita 
Memoria di funzione convertita 
Tabel.a della memoria di controllo 


Tabelle dell'unità di controllo memoria dati 


Se le informazioni sono stampate, la procedura DUMP per prima cosa visua- 
lizza e stampa il sommario della copia nella memoria di sistema. E' inoltre 
possibile selezionare una o più delle seguenti opzioni: 


M 


Vv 


Memoria centrale non convertita tra limiti 
Memoria virtuale non convertita tra limiti 
Memoria della funzione non convertita tra limiti 
Tabelle della memoria di controllo 

Tabelle unità di controllo memoria dati 

Copia della memoria del nucleo 


Copia del blocco di controllo organizzato, dove sono stampate le aree di 
memoria di uso frequente comprese le tabelle della memoria di controllo. 


ATA 


S Copia della memoria di sistema che comprende quanto segue: 
e Una copia della memoria del blocco di controllo organizzato 
e Una copia della memoria del nucleo 


e Una copia della memoria delia memoria di funzione convertita per 
ciascun programma di ciascuna funzione compresa nel file di copia 
della memoria 


e Una copia della memoria della memoria virtuale associata con la 
funzione errata 


e Una copia della memoria della tabella di traccia 


e Unalista DFA 


T Tutte le tabelle di traccia e file principali e alternate. 


Per listare la memoria convertita di un'altra funzione, modificare l'indirizzo 
del blocco di funzione indicato sullo schermo. Una copia della memoria di si- 
stema contiene la memoria convertita per tutte le funzioni che erano attive 
al momento della terminazione normale, mentre una stampa della funzione 
contiene soltanto la memoria per funzioni selezionate. 


Per listare la memoria convertita di un altro programma per questa funzione, 
modificare l'indirizzo del blocco richiesto indicato sullo schermo. 


Per listare la memoria virtuale, cambiare l'indirizzo del blocco di memoria 
indicato sullo schermo. 


Le aree dei dati di memoria di controllo contengono quanto segue: 


e Area diretta 0 (da esadecimale 0000 a esadecimale 007F) 


Area diretta 1 (da 
Area diretta 2 (da 
Area diretta 3 (da 
Area diretta 4 (da 
Area diretta 5 (da 
Area diretta 6 (da 
Area diretta 7 (da 


esadecimale 1000 a 
esadecimale 2000 a 
esadecimale 3000 a 
esadecimale 4000 a 
esadecimale 5000 a 
esadecimale 6000 a 


esadecimale 7000 a 


esadecimale 107F) 
esadecimale 207F) 
esadecimale 307F) 
esadecimale 407F) 
esadecimale 507F) 
esadecimale 607F) 


esadecimale 707F) 


e Area di codice guasto per errore di macchina (da esadecimale 7A00 a 
esadecimale 7B7F) 


e Altrearee varie 


Se la procedura DUMP MAIN è avviata usando la specifica OCL EVOKE o 
viene eseguita dalla coda di lavori, viene stampata una copia della memoria 


del sistema (S). 


803 


804 


CONTROL specifica che devono essere listate le porzioni selezionate di un file di 


copia della memoria di controllo. Se è attiva la riservatezza mediante parola 
d'ordine, l'operatore deve avere un'autorità di sussidio di servizio per poter 
usare la procedura DUMP CONTROL. 


Se le informazioni vengono visualizzate, la procedura DUMP visualizza il 
primo segmento della memoria di controllo. E’ possibile usare i tasti di scor- 
rimento per spostarsi in avanti e all'indietro nei dati. E’ inoltre possibile spe- 
cificare un diverso indirizzo della memoria di controllo. 


Se le informazioni vengono stampate, la procedura DUMP per prima cosa ri- 
chiede i limiti della memoria di controllo. 


Se viene avviata la procedura DUMP CONTROL usando la specifica OCL 
EVOKE o viene eseguita dalla coda di lavori, verrà stampata tutta la memo- 
ria di controllo. 


DISK specifica i settori selezionati del disco o del minidisco da listare. Viene ri- 


chiesto l'indirizzo del primo settore da visualizzare. Se le informazioni vengo- 
no stampate, viene richiesto il numero di settori da stampare. Se è attiva la 
riservatezza mediante parola d'ordine, l'operatore deve avere l'autorità di sus- 
sidio di servizio per poter usare la procedura DUMP DISK. 


IOC specifica che devono essere listate porzioni selezionate del file di copia della 


memoria di controllo dell'unità di controllo di immissione/emissione. Se è 
attiva la riservatezza di mediatne parola d’ordine, l'operatore deve avere l’au- 
torità di sussidio di servizio per poter usare la procedura DUMP IOC. Se le 
informazioni devono essere visualizzate, la procedura DUMP visualizza quan- 
to segue: 


e i’ primo segmento della memoria dell'unità di controllo per la prima 
unità trovata nel file di copia della memoria 


e L'indirizzo della prima unità trovato nel file di copia della memoria. 


Per visualizzare altre porzioni del file di copia della memoria, è possibile usa- 
re i tasti di scorrimento per scorrere in avanti e all'indietro attraverso i dati 
per questa unità. E’ possibile usare i tasti di comando 1 e 2 per spostarsi in 
avanti o all'indietro attraverso le unità nel file di copia della memoria. E' 
inoltre possibile specificare un diverso indirizzo di unità. 


Se le informazioni vengono stampate, la procedura DUMP richiede l'indirizzo 
dell'unità da listare. Se si immette esadecimale 00, vengono listati i dati per 
tutte le unità nel file di copia della memoria. 


Per avere una lista dei possibili indirizzi di unità, premere il tasto di comando 8. 
Se viene avviata la procedura DUMP IOC usando la specifica OCL EVOKE o 


se viene eseguita dalla coda di lavori, vengono listati tutti i dati per tutte le 
unità nel file di copia della memoria. 


JOBO specifica che deve essere listata la coda dei lavori. Se è attiva la riservatez- 


za mediante parola d'ordine, l'operatore deve avere autorità di sussidio si ser- 
vizio per usare la procedura DUMP JOBO. Se le informazioni devono essere 
visualizzate, la procedura DUMP visualizza quanto segue: 


e Il primo segmento della coda dei lavori. 


e Se viene specificato F1 a non è specificato alcun nome file, viene visua- 
lizzato l'indirizzo di settore sequenziale del disco per il primo segmento. 


e Se viene specificato 11 o un nome file, viene visualizzato l'indirizzo rela- 
tivo all'inizio délla coda dei lavori. 
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Per visualizzare altre porzioni del file della coda dei lavori, è possibile usare i 
tasti di scorrimento per spostarsi attraverso i dati per questa unità, 


Se le informazioni vengono stampate, la procedura DUMP stampa l'intero file 
della coda dei lavori. 


MCODE specifica che devono essere listate le seguenti tabelle di microcodifica: 


e Lista dei prerequisiti (compreso l'hardware richiesto, i livelli di modifica 
‘e di rilascio SSP e l’ultima PTF SSP applicata) 


e Tabella di livello di microcodifica (compreso il rilascio della microcodifi- 
ca e i livelli di modifica) 


e Tabelle delle modifiche (compresi gli identificatori dei moduli e le date 
di tutte le modifiche). 


Se è attiva la riservatezza mediante parola d'ordine, l'operatore deve avere 
autorità di sussidio di servizio per poter usare la procedura DUMP MCODE. 


Se le informazioni vengono stampate, la procedura DUMP stampa tutte le ta- 
belle di microcodifica. 


PLD specifica che deve essere listato o visualizzato il file dati livello prodotto. 


PTF specifica che deve essere listato un registro PTF di libreria che identifica tut- 
te le PTF applicate ad una libreria. Se non viene specificato alcun nome di li- 
breria, si presume la libreria di sistema. Se le informazioni devono essere vi- 
sualizzate, la procedura DUMP visualizza il primo segmento del registro PTF. 
Per visualizzare le altre porzioni del registro PTF, è possibile usare i tasti di 
scorrimento per spostarsi attraverso i dati. 


Se viene specificato 11 oppure se è specificato un nome file (non un nome 
di libreria) è possibile usare i tasti di comando 1 e 2 per scorrere in avanti e 


all'indietro nei vari registri PTF. 


Se le informazioni sono stampate, la procedura DUMP stampa l'intero regi- 
stro PTF. 


SERVLOG specifica che deve essere listato il registro di servizio di sistema. Se le 
informazioni devono essere visualizzate, la procedura DUMP visualizza l’en- 
trata più recente ne! registro di servizio, è possibile usare i tasti di scorrimen- 
to per spostarsi attraverso i dati. 


Se le informazioni sono stampate, la procedura DUMP stampa l'intero regi- 
stro di servizio, iniziando con l'entrata più vecchia. 


SPOOL specifica che devono essere listate una o più estensioni del file di stampa 
differita. Se è attiva la riservatezza mediante parola d'ordine, l'operatore deve 
avere autorità di sussidio di servizio per poter usare la procedura DUMP 
SPOOL. Se le informazioni devono essere visualizzate, la procedura DUMP vi- 
sualizza quanto segue: 


e Il primo segmento dell'estensione del file di stampa differita. 


e Se viene specificato F1 e non è specificato un nome di file, viene visua- 
lizzato l'indirizzo di settore sequenziale del disco del primo segmento. 


e Se viene specificato 11 o un file, viene visualizzato l'indirizzo relativo al- 
l’inizio del primo file di stampa differita. 
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Per visualizzare altre porzioni del file di stampa differita, è possibile usare i 
tasti di scorrimento per spostarsi in avanti e all'indietro attraverso i dati. 
Inoltre è possibile usare i tasti di comando 1 e 2 per spostarsi in avanti e al- 
l'indietro attraverso le estensioni del file di stampa differita. 


Se le informazioni vengono stampate, la procedura DUMP stampa tutte le 
estensioni del file di stampa differita. 


STATUS specifica che deve essere listato lo stato (un sommario di copia della 


memoria) di uno o più file di stampa delfa funzione. Se le informazioni de- 
vono essere visualizzate, la procedura DUMP visualizza lo stato del file di 
stampa della funzione più recente. Per visualizzare lo stato di altri file di 
stampa della funzione è possibile usare il tasto scorrimento in alto ( #£) per 
portarsi in avanti attraverso i dati. E’ possibile usare il tasto Scorrimento in 
basso ($) per ritornare al file di copia della memoria più recente. 


Se le informazioni vengono stampate, la procedura DUMP stampa lo stato 
per tutti i file di copia deila funzione, iniziando con i file di copia della fun- 
zione più recente. 


TAPE specifica che devono essere listati i blocchi di nastro selezionati. Viene 


richiesto il numero dei blocchi da stampare. Se è attiva la riservatezza me- 
diante parola d'ordine, l'operatore deve avere l'autorità di sussidi di servizio 
per poter usare DUMP TAPE. 


TRACE specifica che deve essere lisato il file di traccia del disco. Se le informa- 


zioni provengono da un file di stampa della funzione, la procedura DUMP ri- 
chiede il file di traccia specificato da listare. Occorre scegliere uno dei file di 
traccia per continuare. 


Se le informazioni devono essere visualizzate, la procedura DUMP visualizza 
il file di traccia con l’entrata più recente. Per visualizzare altre porzioni del 
file di traccia, è possibile usare i tasti di scorrimento per spostarsi in avanti e 
all'indietro attraverso i dati. 


Se le informazioni vengono stampate, la procedura DUMP stampa il file di 
traccia, iniziando con l’entrata più vecchia. 


TWA specifica che deve essere listata l'area di lavoro della funzione. Se è attiva 


la riservatezza mediante parola d'ordine, l'operatore deve avere autorità di 
sussidio di servizio per poter usare la procedura DUMP TWA. Se le informa- 
zioni devono essere visualizzate, la procedura DUMP visualizza quanto segue: 


e Ii primo segmento dell'area di lavoro della funzione. 


e Se viene specificato F1 e non è specificato un nome di file, viene visua- 
lizzato l'indirizzo di settore sequenziale del disco dei primo segmento. 


e Se viene specificato 11, T1, 12 o un nome di file, viene visualizzato l’indi- 
rizzo relativo all’inizio dell’area di lavoro della funzione. 


Per visualizzare altre porzioni dell’area di lavoro della funzione, è possibile 
usare i tasti di scorrimento per spostarsi avanti e indietro attraverso i dati. E’ 
possibile usare il tasto di comando 1 per spostarsi in avanti attraverso le 
estensioni dell’area di lavoro della funzione. E’ possibile usare il tasto di co- 
mando 2 per ritornare alla prima estensione dell’area di lavoro della fun- 
zione. 


Se le informazioni vengono stampate, la procedura DUMP stampa l’intera 
area di lavoro della funzione. 


IS 


VTOC specifica che deve essere listata la VTOC del disco. Se le informazioni de- 
vono essere visualizzate, la procedura DUMP visualizza quanto segue: 
e Il primo segmento della VTOC del disco. 
e Se viene specificato F1 e non è specificato un nome di file, viene visua- 
lizzato l'indirizzo di settore sequenziale del disco del primo segmento. 


e Se viene specificato l1 o un file, viene visualizzato l'indirizzo relativo al- 
l'inizio della VTOC del disco. 


Per visualizzare altre porzioni dell’area di lavoro di funzione, è possibile usare 
i tasti di scorrimento per spostarsi avanti e indietro attraverso i dati. 


Se le informazioni vengono stampate, la procedura DUMP stampa l’intera 
VTOC del disco. 


PRINTER specifica che l'emissione deve essere stampata sulla stampatrice di ses- 
sione assegnata all'unità video. Se il parametro non è specificato, si presume 
PRINTER. 


CRT specifica che l'emissione deve essere visualizzata sull'unità video che esegue 
la procedura DUMP. Questo parametro non è ammesso se viene specificato 
TAPE. 


F1 specifica che la procedura DUMP deve elaborare le informazioni di copia della 


memoria da un file su disco. Se il parametro non è specificato, si presume F1. 


11 specifica che la procedura DUMP deve elaborare le informazioni di copia della 
memoria da un file su minidisco creato dalla procedura APAR, da una copia 
della memoria di sistema o da una stampa di funzione. Se è stato selezionato 
DISK per il primo parametro, ie informazioni dai settori specificati di minidi- 
sco devono essere elencate per qualsiasi minidisco. Se è stato selezionato 
DISK e il sistema ha un modulo a minidischi a caricatore, il minidisco deve 


essere nell’alimentatore S1. 


T1 o T2 specifica che la procedura DUMP deve elaborare le informazioni da un na- 
stro. Questo potrà essere un nastro creato dalla procedura APAR, da una co- 
pia memoria di sistema, da una copia memoria del lavoro o semplicemente un 
nastro da listare usando come primo parametro TAPE. T1 indica che il nastro 
è montato sull'unità 1. T2 indica che il nastro è montato sull'unità 2. Questo 
parametro non è valido per DUMP DISK. TC specifica che la procedura DUMP 
deve stampare le informazioni da nastro o nastro a cassetta. TC è valido sol- 
tanto se è specificato TAPE nel primo parametro. 
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nome file: Se è specificato F1, questo parametro specifica il file da usare dalla 
procedura DUMP per visualizzare o stampare informazioni. !l file deve essere 
stato creato da una stampa della funzione o dalla procedura TRACE. 1 file 
di copia della memoria sono denominati #DUMP.nn sul disco, dove nn è un 
numero da 00 a 99. Se non viene specificato alcun nome file, la procedura 
DUMP usa la tabella che segue per ottenere le informazioni da listare: 


Parametro Immissione assunta se non è specificato alcun nome file 


MAIN Se avviato da una specifica OCL EVOKE o eseguita dalla 


coda di lavori, si presume il file di stampa della funzione 
più recente; altrimenti viene visualizzato lo stato di tutti i 
CONTROL 
PTF 


file di copia della memoria. Occorre scegliere uno dei file di 
SERVLOG 


copia della memoria per continuare. 
SPOOL 


TRACE 




















La libreria della memoria di controllo. 















La coda dei lavori di sistema. 









La libreria. della memoria di controllo. 








Ii registro PTF della libreria di sistema. 






Il registro di servizio di sistema. 









Il file di stampa differita del sistema. 








Se è avviata da una specifica EVOKE o eseguita dalla coda 
lavori, si presume il file di traccia di sistema. Se la procedu- 
ra DUMP viene eseguita dalla tastiera, viene visualizzato lo 
stato di tutti i file di stampa della funzione che contengono 
file di traccia, seguiti da una lista di tutti i file di traccia 
nell'ambito del file distampa della funzione selezionata. 
Occorre scegliere uno dei file per poter continuare. 























L'area di lavoro della funzione di sistema. 


VTOC La VTOC del disco di sistema. 
| PLD | Il file dati livello prodotto di sistema. | 


Se è specificato 11, la procedura DUMP crea un file su disco residente deno- 
minato nome file e copia il file APARFILE dai minidisco. Se esiste un file di 
copia della memoria su disco con il nome file specificato, il file di copia 
della memoria viene rimosso e ne viene creato uno nuovo, Se il file su disco 
esistente non è un file di copia della memoria, viene visualizzato un messag- 
gio ed è possibile sostituire il file su disco con il nuovo file di copia della 
memoria oppure cancellare la procedura DUMP. 








nome libreria specifica la libreria di cui devono essere listate le informazioni PTF. 
PTF deve essere specificato per il parametro 1. Se è specificato 11, le infor- 
mazioni PTF della libreria per la libreria di sistema sono listate dal file su mi- 
nidisco. Se non è specificato alcun nome di libreria, si presume la libreria di 
sistema. 


0: Se è specificato F1, 0 (zero) indica che DUMP MAIN, DUMP STATUS o 
DUMP TRACE devono usare il file di copia della memoria più recente. Se 
non è specificato alcun parametro e la procedura DUMP viene inserita nella 
coda dei lavori, si presume 0. 


Se è specificato F1 per DUMP MAIN e questo parametro viene omesso, sul 
sistema viene presentato lo stato di ciascun file di stampa della funzione; è 
quindi possibile scegliere quello da elaborare. 


S1, S2 o S3 specifica l'alimentatore del minidisco contenente il primo minidisco 
da usare. Se non viene specificato alcun parametro, si presume S1, 


M1.nn o M2.nn specifica la locazione del caricatore contenente il primo minidi- 


sco da elaborare. M1 indica il primo caricatore e M2 indica il secondo cari- 


catore. nn è un numero da 01 a 10 che identifica la locazione del minidisco 
nel caricatore. Specificare M1 equivale a specificare M1.01; specificare M2 
equivale a specificare M2.01. 


AUTO specifica quanto segue: 


Se viene specificato S1, S2 o S3, è possibile usare tutti e tre i singoli 
alimentatori (S1, S2 e S3). L'elaborazione inizia con il minidisco nel- 
l'alimentatore specificato e-continua fino al minidisco nell'alimentatore 
S3. Se occorrono altri minidischi, viene visualizzato un messaggio e 
l'operatore deve inserire i successivi minidischi. L'elaborazione riprende 
col minidisco nell’alimentatore S1. 


Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli 
alimentatori di caricatore (M1 e M2). L'elaborazione inizia con il mini- 
disco nella locazione specificata e continua fino ai minidisco nella loca- 
zione M2.10. Se occorrono altri minidischi, viene visualizzato un mes- 
saggio e l'operatore-quindi inserisce i successivi caricatori. L'elaborazione 
riprende alla locazione M1.01. 


Se non viene specificato alcun parametro, si assume AUTO. 


NOAUTO specifica quanto segue: 


Esempio 


Se viene specificato S1, S2 o S3, può essere usato soltanto l'alimentato- 
re specificato. Se occorrono altri minidischi, viene visualizzato un mes- 
saggio e l'operatore deve inserire il successivo minidisco nell’alimentato- 
re specificato. 


Se viene specificato M1.nn o M2.nn, può essere usato soltanto il carica- 
tore specificato. L'elaborazione inizia con il minidisco nella locazione 
specificata e continua fino all'ultimo minidisco nel caricatore. Se sono 
necessari altri minidischi, viene visualizzato un messaggio e l'operatore 
deve inserire il successivo caricatore nell’alimentatore che viene usato. 
L'elaborazione riprende alla prima locazione nel caricatore. 


Questo esempio mostra come stampare le informazioni di copia della memoria re- 
lative alla memoria centrale. Le informazioni sono contenute in un file di copia 
della memoria su disco denominato #DUMP.03 che è stato creato per mezzo di 
una stampa di funzione. 


DUMP ,,,#DUMP. 03 
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ERAP 


PROCEDURA ERAP 


La procedura ERAP visualizza o stampa dati registrati per le unità di sistema. In 
relazione all'unità, i dati registrati sono contenuti in una o più delle seguenti ta- 
belle: 


Una tabella dei contatori di immissione/emissione che contiene dati statistici 
cumulati riflettenti la quantità di attività per l’unità. (Per esempio il numero 
di operazioni di verifica, scrittura, lettura o scansione di lettura e di ricerca 
con caratteri diversi da zero su un'unità disco). 


Una tabella di contatori di errori che contiene i totali cumulati di tipi speci- 
fici di errori per l’unità. 


Una tabella cronologica degli errori che contiene un campo per la data, un campo 
per l'ora, un codice riferimento di sistema (SRC) che rappresenta un errore su di 
una unità, e un byte di stato che fornisce ulteriori dettagli circa l'errore. La prima vo- 
ce in tabella rappresenta la voce più recente. Quando la tabella è piena, la voce più 
vecchia è eliminata dalla tabella ogni volta che una nuova voce è aggiunta. 


Oltre a stampare o visualizzare le informazioni registrate, la procedura ERAP con- 
sente di ripristinare le informazioni nelle tabelle dei contatori di immissione/emis- 
sione e nelle tabelle di contatori di errori. 


Quando inizia, la procedura ERAP visualizza una serie di menù dai quali è possi- 


bile 


scegliere: 

| prospetti unità per le quali devono essere visualizzate o stampate le infor- 
mazioni registrate. 

Le informazioni registrate da visualizzare o stampare. 


La stampatrice sulla quale l'emissione deve essere stampata (se viene scelta 
la stampa). 


Il periodo di tempo durante il quale le informazioni registrate devono essere 
stampate o visualizzate. 


La procedura ERAP esegue il programma di utilità $FEAIDS, 


La procedura ERAP non ha parametri. 


Esempio 


Questo esempio mostra come avviare la procedura ERAP. 


ERAP 


PATCH 


PROCEDURA PATCH 


Fl 
Il 


La procedura PATCH visualizza settori selezionati del disco o del minidisco e 
consente di modificare i dati presenti in quel settore. 


La procedura PATCH richiede il numero di settore che si desidera visualizzare. Il numero 
di settore deve essere specificato in esadecimale o decimale. Quando si visualizzano set- 
tori di minidisco, è anche possibile specificare il numero di cilindro, il numero di testina e 
il valore del record nel formato esadecimale o decimale. Vengono quindi visualizzati i pri- 
mi 256 byte del settore selezionato unitamente all'indirizzo del settore. Aitre porzioni del 
disco o del minidisco possono essere visualizzate immettendo un nuovo indirizzo di set- 
tore o usando i tasti di funzione per scorrere attraverso i dati della memoria del minidisco 
o del disco. È possibile modificare le informazioni del disco o del minidisco sostituendo i 
dati visualizzati sullo schermo con nuovi dati. 


Nota: Si dovrà prestare molta attenzione con l'utilizzo della procedura PATCH, poi- 
ché essa consente di modificare molte aree dati critiche di sistema. 


Poichè la procedura PATCH consente di modificare i dati del disco, PATCH può 
essere eseguita soltanto dalla console di sistema se non è attiva la riservatezza 
mediante parola d'ordine. Se è attiva la riservatezza mediante parola d'ordine, 
la procedura può essere eseguita da qualsiasi unità video ma l'esecuzione della 
procedura PATCH è limitata agli operatori che hanno autorità di sussidio di 
servizio. Per ulteriori informazioni sull'autorità di sussidio di servizio, vedere il 
manuale Guida alla Riservatezza del Sistema. 





F1 specifica che deve essere usato il disco. Se non è specificato un parametro, si 
presume F1. 


11 specifica che deve essere usato un minidisco. Se il sistema ha un modulo a mi- 
nidischi con caricatore, il minidisco deve essere nell'alimentatore S1. 


Esempio 


Questo esempio mostra come usare la procedura PATCH per modificare uno o 
più settori di minidisco. Il minidisco è nell’alimentatore S1. 


PATCH 11 
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PROCEDURA PTF 


La procedura PTF consente di applicare correzioni temporanee di programma 
(PTF) ad una libreria specificata. La procedura PTF consente di eseguire quanto 
segue: 


e Copiare le PTF da un minidisco PTF su una libreria PTF. 
* Applicare le PTF da una libreria PTF ad una libreria specificata. 


*e Applicare le PTF direttamente da un minidisco PTF ad una libreria specifi 
cata. 


e Listare il registro PTF per una libreria specificata. 

e Rimuovere una PTF da una libreria specificata. 

e Salvare una libreria di riserva PTF su minidisco. 

e Ripristinare una libreria di riserva PTF da minidisco. 

e Cancellare una libreria di riserva PTF da minidisco o disco. 
e  Correggere un membro di libreria su disco, 

e Copiare una PTF in microcodifica su una libreria PTF. 


e Applicare una PTF in microcodifica da una libreria PTF alla libreria di me- 
moria di controllo. 


e Rimuovere una PTF in microcodifica. 


I minidischi PTF devono essere elaborati in ordine ascendente secondo il loro nume- 
ro di volume. Per esempio il volume 01 deve essere alimentato per primo, seguito 
dal volume 02 fino all'ultimo minidisco. 


Per applicare una PTF sul sistema eseguire i passi che seguono: 
e PTF COPY 

* PTFAPPLY 

e PTF SAVE 


Nota: la PTF APPLY richiede il sistema dedicato senza attività in esecuzione su di 
esso. 


Per ulteriori informazioni sulla procedura PTF, vedere il manuale Guida Operativa. 


Pannni 


Per copiare le PTF per i programmi su licenza forniti dalla IBM o SSP, su una li- 
breria PTF su disco: 


LO 


COPY, | OLD s[tipo pif > [none libreria pes | 
ALL ALLPTF 


numero di registro ptf| |nome file ptf 


CHECK s| SL s | AUTO sl ampiezza libreria] ,|ampiezza 
NOCHECK| {S2 NOAUTO} |di lavoro indirizzario 
53 50 10 
Ml.nn Ha 

M2.nn 





Per applicare ie PTF da una libreria PTF ad una libreria di programmi su licenza 
o SSP: 


APPLY,,|tipo ptf ; [nome libreria di destinazione | 


ALLPTF 
nome libreria ptif 
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Per applicare direttamente le PTF da un minidisco PTF ad una libreria specificata: 

















dà DIRECT, ]OLD ,|tipo ptf 
ALL ALLPIF 
numero di registro ptf| |nome file ptf 
[pone libreria di destinazione] »| Sl » |AUTO 
S2 NOAUTO 
53 
Ml.nn 
M2.nn 
Per listare le informazioni PTF relative ad una libreria: 
LIST,nome libreria di destinazione, |PRINTER 
CRT 
id stampatrice 
Pea 


Per rimuovere una PTF da una libreria di programmi su licenza o SSP: 





EMOVE, |ALL ssa pif ,l nome libreria 
numero di registro ptf| | ALLPIF di riserva 
nome libreria di 
destinazione 





Per salvare su minidisco una libreria di riserva PTF: 


SAVE,|tipo ptf s {ia volune| s|S1 , | AUTO 
ALLPTF so NOAUTO 


nome libreria di riserva 53 
Ml.nn 


M2.nn 
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Per ripristinare una libreria di riserva PTF da minidisco: 


RESTORE,|tipo ptf i s}Al|,|Sl s [AUTO 
ALLPTF AQ S2 NOAUTO 


nome libreria di riserva 83 
Ml.nn 
M2.nn 





Per cancellare una libreria di riserva PTF da disco o minidisco: 











PIF DELETE, |tipo ptf s{Fl1/,|Sl1 
ALLPTF il S2 
nome libreria di riserva 53 

NE Ml.nn 


M2.nn 


Per correggere un membro di libreria su disco: 


PIF PATCH 


Per copiare una PTF in microcodifica su una libreria PTF: 












PTF na J Sl s AUTO |, 
PIF nome libreria S2 NOAUTO 
S3 
Ml.nn 
M2.nn 


6 ampiezza libreria LA indirizzario 
50 10 
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Per applicare una PTF in microcodifica da una libreria PTF alla libreria di memo- 
ria di controllo; . 


PTF MAPPLY, |ALL s|CSPTFLIB . 


PTF numero registr. PIF nome libreria 





Per rimuovere una PTF in microcodifica: 


PTF nome libreria 


PTF MREMOVE, [PIF numero registr.| |erme 





COPY specifica che le PTF devono essere copiate da un minidisco PTF su una li- 
breria PTF. La funzione COPY crea una libreria PTF. Questa libreria contie- 
ne le PTF che devono essere applicate alla libreria specificata. Per SS1, ad 
esempio, la libreria sarebbe la libreria di sistema #LIBRARY. Il nome della 
libreria PTF è PTFxxxxx dove xxxxx sono i primi 5 caratteri del nome file 
del minidisco; per esempio, per SS101 il nome sarebbe PTFSS101. 


APPLY specifica che le PTF devono essere applicate da una libreria PTF ad una 
libreria specificata. La libreria PTF deve essere stata creata usando la funzio- 
ne COPY. | moduli che ricevono le PTF sono copiati su una libreria di riser- 
va PTF. La libreria di riserva PTF contiene i moduli che vengono sostituiti 
dalle PTF; cioè la libreria di riserva contiene moduli di livello più basso. | 
moduli PTF sono copiati sulla libreria specificata; per esempio, per SS101, la 
libreria di sistema. 


I moduli di iivello basso rimangono nelia libreria di riserva PTF fino a che 
non viene applicata una nuova serie di PTF alla libreria specificata. La libre- 
ria di riserva PTF è denominata PTBxxxxx, dove xxxxx sono gli ultimi 5 ca- 
ratteri del nome di libreria PTF; per esempio, per la libreria PTF PTFSS101, 
la libreria di riserva è denominata PTBS$101. 
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DIRECT specifica che le PTF devono essere applicati direttamente da un minidi- 
sco PTF ad una libreria specificata. 


REMOVE specifica che le PTF deono essere rimosse da una libreria specificata. 
I moduli di livello inferiore sono copiati dalla libreria di riserva PTF sulla li- 
breria specificata, sostituendo i moduli PTF. 


LIST specifica che deve essere stampato o visualizzato il registro PTF (FPTFLOG) 
per una libreria. 


SAVE specifica che deve essere salvata su minidisco una libreria di riserva PTF. 


RESTORE specifica che deve essere ripristinata da minidisco una libreria di riser- 
va PTF. 


DELETE specifica che deve essere cancellata da disco o da minidisco una libreria 
di riserva PTF. 


PATCH specifica che un membro di libreria o una libreria possono essere modifi- 
cati direttemnete usando l’unità video. Se è attiva la riservatezza mediante 
parola d'ordine, PTF PATCH può essere eseguito da qualsiasi unità video ma 
soltanto da un operatore che ha autorità di sussidio di servizio. 


PTF PATCH esegue il programma di utilità $SFEFIX. Vedere il manuale Pro- 
gram Problem Diagnosis and Diagnostic Aids per informazioni sulle specifiche 
di controllo richieste da questo programma di utilità. 


MCOPY specifica che le PTF in microcodifica devono essere copiate dal minidi- 
sco PTF sulla libreria PTF in microcodifica (CSPTFLIB). 


MAPPLY specifica che le PTF in microcodifica devono essere applicate dalla li- 
breria PTF (CSPTFLIB) alla libreria della memoria di controllo. 


MREMOVE specifica che la PTF in microcodifica deve essere rimossa dalla libre- 
ria della memoria di controllo. La PTF rimossa si trova nella libreria PTF 
(CSPTFLIB). 


OLD specifica che le PTF devono essere elaborate soltanto per i memrbi di libre- 
ria esistenti. Se non vengono specificati parametri, si presume OLD. 


. ALL specifica che devono essere elaborate tutte le PTF. 


numero di registro ptf log specifica che devono essere elaborate soltanto le PTF 
corrispondente al numero immesso. Questo numero specifica il numero di re- 
gistro PTF che è indicato nei membro origine denominato PTFXREF su cia- 
scun minidisco. 


ATX 


ER 


«“—— — -— — — — — _—— — — — +— — — —_. — — 


ALLPTF specifica che devono essere elaborate tutte le PTF che devono esse- 
re usate con la configurazione corrente di sistema. Per esempio, se il sistema 
avesse SSP, i programmi di utilità, RPG, COBOL e BASIC, verrebbero elabo- 
rate soltanto le PTF per quei programmi su licenza. Qualsiasi altra PTF, ad 
esempio FORTRAN, non verrebbe elaborata. 


tipo ptf specifica il tipo di PTF da elaborare. La tabelia che segue mostra i tipi di 
PTF con la libreria associata e una sua descrizione. nn è il Release SSP. Per 
esempio, per elaborare le PTF del Release 2 del SSP, si dovrà immettere SS102. 










sw 
susuLE 
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Quando vengono specificati APPLT e DIRECT, possono essere elaborate soltanto 
le PTF per SS1-nn e ALL PTF: 


e Non vengono eseguiti altri lavori 
e Nonci sono altri utenti collegati su qualsiasi altra unità video. 
° I terminali a distanza sono fuori linea 


e Le sessioni dei dispositivi di comunicazione interattivi (SSP-ICF) sono 
disabilitate 


e Le linee di comunicazione sono fuori linea. 


nome file ptf specifica il nome del file su minidisco PTF che contiene le PTF da 
copiare e applicare al sistema. 


nome libreria ptf specifica il nome della libreria che deve contenere le PTF. Que- 
sta libreria viene automaticamente determinata dal tipo delle PTF che vengo- 
no copiate o applicate. In ogni caso, l'immissione di un valore per questo pa- 
rametro esclude temporaneamente il processo automatico di denominazione. 


nome libreria di destinazione specifica il nome della libreria alla quale saranno 
applicate le PTF. Questo nome di libreria viene automaticamente determina- 
to dal tipo di PTF che vengono copiate o applicate. In ogni caso, l'immissio- 
ne di un valore per questo parametro esclude temporaneamente il processo 
automatico di denominazione. > 


nome libreria di riserva specifica il nome della libreria che conterrà le copie di 
ciascun modulo al quale saranno applicate le PTF. 


CHECK specifica che deve essere effettuato un controllo di livello di rilascio e 
dei prerequisiti quando il file su minidisco viene copiato su disco nella libre- 
ria PTF. Se una PTF che viene copiata ha una PTF prerequisita che non è 
già sul sistema, anche questa deve essere copiata nella libreria PTF, prima di 
poter essere applicata alla libreria specificata. 


NOCHECK specifica che non devono essere eseguiti controlli di livello di rilascio 
o dei prerequisiti. 


AI 


A2 


A2 


A4 


S1, 


specifica che la locazione preferita del file su disco è sul primo disco. Se è 
disponibile spazio, la libreria di riserva delle PTF viene inserita sul primo 
disco; altrimenti la libreria viene inserita sul secondo disco. 


specifica che la locazione preferita del file su disco è sul secondo disco. Se è 
disponibile spazio, la libreria di riserva delle PTF viene inserita sul secondo 
disco; altrimenti la libreria viene inserita su A1, se si dispone di due o quat- 
tro unità disco, oppure su A3, se si dispone di tre unità disco. 


specifica che la locazione preferita del file su disco è sul terzo disco. Se è 
disponibile spazio, la libreria di riserva delle PTF viene inserita sul terzo 
disco; altrimenti la libreria viene inserita su A2, se ci sono tre unità disco o 
su A4, se ci sono quattro unità disco. 


specifica che la locazione preferita del file su disco è sul quarto disco. Se è 
disponibile spazio, la libreria di riserva delle PTF viene inserita sul quarto 
disco; altrimenti viene inserita su A3. 


S2 o S3 specifica l'alimentatore del minidisco contenente il primo minidisco 
da usare. Se non viene specificato alcun parametro, si presume S1. 


Mi.nn o M2.nn specifica la locazione del caricatore contenente il primo minidi- 


sco da elaborare. M1 indica il primo caricatore e M2 indica il secondo cari- 
catore. nn è un numero da 01 a 10 che identifica la locazione del minidisco 
nel caricatore. Specificare M1 equivale a specificare M1.01; specificare M2 
equivale a specificare M2.01. 


AUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, è possibile usare tutti e tre i singoli 
alimentatori (S1, S2 e S3). L'elaborazione inizia con il minidisco nel- 
l'alimentatore specificato e continua fino al minidisco nell’alimentatore 
S3. Se occorrono altri minidischi, viene visualizzato un messaggio e 
l'operatore deve inserire i successivi minidischi. L'elaborazione riprende 
col minidisco nell’alimentatore S1. 


e Se viene specificato M1.nn o M2.nn, possono essere usati entrambi gli 
alimentatori di caricatore {M1 e M2). L'elaborazione inizia con il mini- 
disco nella locazione specificata e continua fino al minidisco nella loca- 
zione M2.10. Se occorrono altri minidischi, viene visualizzato un mes- 
saggio e l'operatore quindi inserisce i successivi caricatori. L'elaborazione 
riprende alla locazione M1.01. 


Se non viene specificato alcun parametro, si assume AUTO. 


NOAUTO specifica quanto segue: 


e Se viene specificato S1, S2 o S3, può essere usato soltanto l’alimentato- 
re specificato. Se occorrono altri minidischi, viene visualizzato un mes- 
saggio e l'operatore deve inserire il successivo minidisco nell'alimentato- 
re specificato. 


e Se viene specificato M1.nn o M2.nn, può essere usato soltanto il carica- 
tore specificato. L'elaborazione inizia con il minidisco nella locazione 
specificata e continua fino all'ultimo minidisco nel caricatore. Se sono 
necessari altri minidischi, viene visualizzato un messaggio e l'operatore 
deve inserire il successivo caricatore nell’alimentatore che viene usato. 
L'elaborazione riprende alla prima locazione nel caricatore. 
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ampiezza libreria di lavoro specifica la dimensione (in blocchi) della libreria tempo- 
ranea che viene usata nell'elaborazione COPY. Se non è specificato alcun pa- 
rametro viene calcolato il valore occorrente. Questo valore potrà essere al mas- 
simo 50 blocchi. 


ampiezza indirizzario specifica la dimensione (in settori) dell’indirizzario per la libre- 
ria temporanea. Se non è specificato alcun parametro, vengono allocati 2 set- 
tori per ciascun blocco. 


Esempio 1 


Questo esempio mostra come applicare le PTF per il rilascio 1 del SSP. PTF 
COPY copia tutte le PTF dal minidisco PTF su una libreria PTF su disco; la li- 
breria viene denominata PTFSS101. PTF APPLY applica effettivamente le PTF 
al SSP. La funzione APPLY copia inoltre i membri SSP che stanno ricevendo le 
PTF su una libreria di riserva PTF, denominata PTBSS101. 


PTF COPY,ALL,SS101 
PTF APPLY,,SS101 


Esempio 2 


Questo esempio mostra come stampare le PTF che sono state applicate alla libre- 
ria di sistema. 


PIF LIST,#LIBRARY 


SERVICE 


PROCEDURA SERVICE 
La procedura SERVICE visualizza un menù che consente di eseguire le varie fun- 
zioni richieste per eseguire la diagnostica e la correzione di un problema. Queste 


funzioni comprendono: 


e Esecuzione delle procedure di sussidio di servizio per effettuare la diagnostica 
relativa ai programmi (ad esempio: DUMP, APAR, DFA e TRACE). 


e Esecuzione delle procedure di sussidio di servizio per effettuare la diagnostica 
relativa all'hardware (ad esempio: ERAP). 


e Copia di applicazione di correzioni temporanee ai programmi (PTF) ai pro- 
grammi su licenza. 


e Aggiunta di entrate o lista delle registrazioni di servizio del sistema. 


e Esecuzione della procedura PATCH per visualizzare o modificare settori di 
disco o di minidisco. 


La procedura SERVICE non ha parametri. 


Esempio 


Questo esempio mostra come immettere la procedura SERVICE per visualizzare il 
menù SERVICE. 


SERVICE 
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Pagina lasciata intenzionalmente bianca 


O 








PROCEDURA SERVLOG 


La procedura SERVLOG consente di aggiungere entrate nel registro di servizio 
del sistema. La procedura SERVLOG può essere eseguita da qualsiasi unità video. 


Per visualizzare o stampare le entrate del registro di servizio, vedere la Procedura 
DUMP. 


_SERVLOG 'testo messaggio per il rapporto di servizio! 





‘testo messaggio per il registro di servizio’ specifica l'entrata da effettuare nel re- 
gistro di servizio. ll testo deve essere racchiuso tra apici (’). 


Esempio 


Questo esempio mostra come aggiungere l’entrata SOSTITUITA NUOVA TA- 
STIERA ALA CONSOLE DI SISTEMA al registro di servizio di sistema. 


SERVLOG 'SOSTITUITA NUOVA TASTIERA ALLA CONSOLE DI SISTEMA! 
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PROCEDURA SETDUMP 


La procedura SETDUMP consente di eseguire la ricerca e correzione degli errori 
di programmi che vengono eseguiti nella memoria centrale in punti di interruzio- 
ne o indirizzi predeterminati senza dover interrompere l’unità di elaborazione 
della memoria centrale. La procedura SETDUMP consente di eseguire una stampa 
della funzione del programma quando viene fatto riferimento ad un indirizzo nel 
programma. 


I file di copia della memoria sono denominati #DUMP.nn sul disco, dove nn è un 
numero da 00 a 99. 


ADDRESS 
RESTART 


TASK 
OFF 





Se non vengono specificati parametri, viene visualizzato un menù ed è possibile 
scegliere la funzione desiderata. 


ADDRESS specifica che deve essere visualizzata la richiesta usata per impostare i 
valori di confronto dell'indirizzo. Verrà così riavviato un lavoro che era stato 
precedentemente interrotto dalla funzione di copia della memoria di con- 
fronto dell'indirizzo. 


RESTART specifica che la funzione di copia della memoria per confronto del- 
l'indirizzo deve essere abilitata per consentire l'effettuazione di un'altra copia 
della memoria per confronto dell'indirizzo usando i valori di indirizzo prece- 
dentemente definiti. Un lavoro che era stato precedentemente sospeso dalla 
funzione di copia dalla memoria per confronto dell'indirizzo sarà ripreso. 


TASK specifica che deve essere immediatamente eseguita una stampa della me- 
moria per un'attività specificata. Un lavoro che era stato precedentemente 
sospeso dalla funzione di stampa della memoria di confronto dell'indirizzo 
sarà ripreso. 


OFF specifica che la funzione di stampa della memoria di confronto dell’indiriz- 
zo deve essere disabilitata. Un lavoro che era stato precedentemente sospeso 
dalla funzione di copia della memoria di confronto dell'indirizzo sarà ripreso. 


Esempio 
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L'esempio che segue mostra come immettere la procedura SETDUMP per definire 


valori di copia della memoria di confronto di indirizzo. 


SETDUMP ADDRESS 


PROCEDURA TRACE 


La procedura TRACE consente di'tenere una registrazione cronologica degli even- 
ti che si verificano nel sistema. Gli eventi scelti vengono registrati nella memoria 
centrale man mano che si verificano in una tabella di lunghezza variabile a scorri- 
mento circolare. Può essere attiva una sola copia della funzione alla volta, 


La procedura TRACE può essere eseguita in due modi diversi: 1) La procedura 
può essere eseguita interattivamente: cioè la procedura visualizzerà lo stato di cia- 
scuna tabella di traccia e richiederà eventuali modifiche. 2) La procedura può es- 
sere immessa con parametri consentendo l’esecuzione dalla coda di lavori, l’esecu- 
zione da un'altra procedura o addirittura essere considerata una delle procedure 
di avviamento IPL. 


E’ possibile tracciare da 16 a 512 entrate nella tabella di traccia della memoria 
centrale. Si possono inoltre creare o cancellare tabelle di traccia alternative. E’ 
possibile selezionare la traccia per uno qualsiasi dei seguenti eventi: 


e Una qualsiasi o una combinazione di richiami del supervisore della memoria 
centrale (SVC) 


e Richiami di supervisore del processore della memoria di controllo. 
e invii di funzione, 

e Scambi di funzione. 

e Operazione di immissione/emissione sul disco. 

e Eventi legati ai componenti ad esempio: 


— Funzioni WSU 
— Funzioni terminali a distanza 


— Supporto comunicazioni asincrone 


— BSC 

— SNA 

— . SDLC 

—  X.25 

—  MSRJE 
— SSP-ICF 
— APPC 


E’ possibile inoltre selezionare le opzioni di registrazione su disco e, se è stato 


scelto qualsiasi evento legato alle comunicazioni, è possibile selezionare le linee di 
comunicazione da tracciare. 
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CRT 3 [rome tabella] s| OLD 4 [rimensione tabella | 4 
BATCH NEW 

MOD 

REMOVE 


CURRENT » |START , [Gim. file traccia |, [linee comuni. | 
'lista eventi! STOP 


Se non vengono specificati parametri, TRACE richiede i valori dei parametri. 


CRT specifica che la procedura deve essere eseguita interattivamente. Vengono 
richiesti taluni parametri TRACE. Se questi parametri non vengono immessi, 
si presume CRT. 


BATCH indica che sono stati specificati tutti i valori dei parametri, siano essi 
quelli assunti per difetto o altri diversi. 


nome tabella specifica il nome della tabella di traccia sulia quale verranno traccia- 
ti gli eventi. Se non viene specificato alcun nome si presume la tabella di 
traccia principale. 


OLD specifica che la tabella di traccia esiste già. Se non è possibile trovare la ta- 
bella, viene visualizzato un messaggio di errore. Se questo parametro non 
viene specificato, si presume OLD. 


NEW specifica che quella indicata è una nuova tabella di traccia alternativa. Se- 
esiste già una tabella con questo nome, viene visualizzato un messaggio di 
errore, 


MOD specifica che se esiste già la tabella, questa verrà modificata secondo gli al- 
tri parametri specificati. Se la tabella mon esiste, verrà creata una tabella di 
traccia con i valori degli altri parametri specificati. 


REMOVE specifica che deve essere cancellata la tabella alternativa di traccia indi- 
cata. Se è attiva la registrazione su disco, la registrazione viene interrotta pri- 
ma che la tabella venga cancellata. {I file di traccia su disco non viene cancel- 
lato. La tabella principale di traccia non può essere cancellata. 


dimensione tabella specifica il numero massimo di entrate che la tabella di traccia 
può contenere. | numeri di entrata validi che possono essere registrati su una 
tabella sono 16, 24, 32, 40, 48, 56, 64, 128, 192, 256, 320, 384, 448 e 512. 
Può essere specificato qualsiasi altro numero nel campo da 16 a 512 ma que- 
sto ‘sarà arrotondato per eccesso al successivo numero valido. Se questo para- 


metro non viene specificato e la tabella è nuova, si presume una dimensione 
di tabella di 16 entrate. 


CURRENT specifica che verranno tracciati gli eventi precedentemente selezionati 
per la traccia, Se viene specificato CURRENT per una nuova tabelle di trac- 
cia, viene visualizzato un messaggio di errore. 


‘lista eventi’ specifica gli eventi o profili da tracciare. Se deve essere tracciato più 
di un evento o profilo, i valori per questo parametro devono essere racchiusi 
tra apici e gli eventi o i nomi dei profili devono essere separati da virgole. La 
lunghezza totafe del parametro non può superare gli 82 caratteri, comprese le 
virgole e gli apici. E' possibile specificare qualsiasi evento listato usando il 
metodo interattivo di questa procedura. Se si desidera rimuovere eventi trac- 
ciati da una tabella di traccia, immettere un segno meno (—) davanti all’even- 
to da rimuovere, L'inserimento di un segno meno davanti ad un profilo non 
rimuove gli eventi che il profilo rappresenta. Gii eventi vengono aggiunti al 
profilo della tabella di traccia o rimossi dal profilo della tabella di traccia 
nell'ordine in cui compaiono nella lista. 


START specifica che la tabella di traccia deve iniziare a registrare su disco. Il 
nome della tabella di traccia deve essere diverso dal nome di un file su disco 
dell'utente esistente, altrimenti viene visualizzato un messaggio di errore. 


STOP specifica che la tabella di traccia deve interrompere ia registrazione su 
disco. 


dimensione file traccia specifica la dimensione del file di traccia in blocchi. Cia- 
scun blocco dei file conterrà approssimativamente 80 entrate di traccia. Se 
questo parametro non viene specificato e viene avviata la registrazione su 
disco, e non esiste file di traccia, ne viene creato uno di 10 blocchi. 


linee comm. specifica per quali linee di comunicazione devono essere tracciati gli even- 
ti. Specificare uno o più numeri senza spazi vuoti o virgole incorporate per indicare 
le linee di comunicazione. Per esempio, per tracciare le linee 1 e 3 è possibile immet- 
tere 13 o 31. Se questo parametro non viene specificato e gli eventi o i profili listati 
richiedono la traccia della linea, e non erano state tracciate precedenti linee di co- 
municazione, verranno tracciate tutte le linee di comunicazione. 
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Appendice D. Programma diutilità perla conversione 
delle serie di caratteri multinazionali 


INTRODUZIONE 


Il dispositivo della serie di caratteri multinazione (MCS) è un programma di utili- 
tà del Sistema/36 che mette a disposizione una serie ampliata di 188 caratteri 
multinazionali per la maggior parte dei gruppi linguistici nei Paesi in cui è dispo- 
nibile il Sistema/36. La serie comprende 112 caratteri alfabetici, 10 caratteri nu- 
merici e 66 caratteri speciali. Ad alcuni caratteri della serie di caratteri ampliata 
sono stati assegnati valori esadecimali diversi rispetto a quelli che avevano in pas- 
sato. A causa di queste modifiche nei valori esadecimali, occorre avere questo 
programma di utilità di conversione per convertire il valore relativo alla versione 
della lingua nazionale (NLV) nel nuovo valore MSC in modo che i caratteri visua- 
lizzati o stampati corrispondono all’appropriato valore MCS. 


Vedere Caratteri modificati per gruppo di lingua per una descrizione dei caratteri 
specifici dei gruppi di lingua interessati dalla serie di caratteri multinazionali. 


ll programma di conversione della serie di caratteri multinazionali (MCSCU) è 
composto da una serie di programmi di utilità che rendono possibile la conversio- 
ne stessa, i programmi MCSCU aiutano a convertire membri origine di libreria, 


membri di procedura di libreria e file di dati dalla rappresentazione in versione 
esadecimale della lingua nazionale al nuovo valore MCS e viceversa. 


| programmi e le procedure MCSCU: 
e Richiedono le informazioni necessarie per eseguire il programma di utilità. 


e  Convertono i membri di libreria in un file di lavoro e inseriscono i risultati 
nella stessa o in un’altra libreria specificata. 


e Stampano una lista di controllo dei membri esaminati. 

e Convertonoi file di dati 

e Stampano una lista delle istruzioni o dei record convertiti (facoltativo). 
e Modificano le specifiche o i record (facoltativo) 


e Contano le specifiche o i record convertiti in un membro o in un file (facol- 
tativo). 


Quando si usa il programma di utilità di conversione della serie di caratteri multi- 
nazionale, occorre specificare il tipo dei record che vengono convertiti: specifiche 
di procedura o file di dati. | tipi di specifiche nei membri di libreria che vengono 
soggetti a conversione comprendono RPG, COBOL, FORTRAN, Assembler, sort, 
DFU, membro di messaggi, tracciati video, WSU, OCL e menù. 


Per informazioni sull’installazione di MCSCU, vedere il manuale Modifica della 
configurazione del sistema. 
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SUPPORTO HARDWARE 5250 


Oltre alle unità standard del Sistema/36, il MCSCU supporta modelli delle unità 
video 5250 che dispongono del dispositivo MCS. L'installazione del dispositivo 
serie di caratteri multinazionali del 5250 richiede la conversione di qualsiasi dato 
Carattere salvato o memorizzato internamente che abbia un nuovo valore esadeci- 
male in MCS. 


Il dispositivo hardware MCS non deve essere installato sul sistema per poter ese- 
guire il MCSCU. Ma se non lo è, tutte le funzioni potrebbero non risultare acces- 
sibili; per esempio, l'impostazione da tastiera dei nuovi valori esadecimali per modi- 
che manuali, l'impostazione da tastiera di tabelle di conversione alternative fornite 
dall'utente o la stampa di nuovi caratteri. 


AVVIAMENTO DEL PROGRAMMA DI UTILITA’ DI CONVERSIONE 


Suì video comandi del Sistema/36 immettere il seguente comando di procedura: 
MCSCONV 


Non ci sono parametri. 


Viene richiesto di battere il tipo di lavoro di conversione che si vuole eseguire: 
cioè se lavorare con membri di libreria o con file di dati. Compare lo schermo di 
Figura 36. 


CONVERSIONE GRUPPO CARATTERI MULTINAZIONALI 


Conversione di membri origine o di procedura e file di dati della lingue 
nazionale in un gruppo di caratteri multinazionali o da un gruppo di 
caratteri multinazionali in lingua nazionale 


Scegliere una delle opzioni:. 


ì. Conversione membri origine o di procedura 
2. Conversione file di dati 
3. Fine programma di utilità per conversione 


Opzione: ... 





Figura 36. Schermo delle opzioni di conversione 


Se sì sceglie l'opzione 1, vengono richieste le informazioni necessarie per elabora- 
re i membri di libreria. Vedere Conversione dei membri di libreria. 


Se si sceglie l'opzione 2, vengono richieste le informazioni necessarie per elabora- 
re un file di dati. Vedere Conversione dei file di dati. 


Per terminare il programma di utilità di conversione, scegliere l'opzione 3. 
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CONVERSIONE DEI MEMBRI DI LIBRERIA 


I componenti base di qualsiasi installazione sono le risorse di programmazione appli- 
cative. In una libreria queste risorse assumono quattro forme: membri di procedura, 
membri origine, membri di sottoroutine e membri oggetto. | membri origine a loro 
volta possono essere suddivisi in tipi diversi: RPG, COBOL, FORTRAN, Assembler, 
sort, DFU, membri messaggi, tracciati video, WSU e membri di menù. 


Ciascun tipo di specifica origine può contenere caratteri sotto forma di costanti, 
richieste a video e testate di stampatrice e così via, che hanno assunto un nuovo 
valore esadecimale sotto MCS. Quando viene eseguito un programma su un siste- 
ma con il dispositivo MCS, i tracciati video e i prospetti stampati mostrano il ca- 
rattere associato con il valore MCS invece del carattere nella versione della lingua 
nazionale. Il MCSCU aiuta nel trovare caratteri nell'ambito delle specifiche origi- 
ni e delle procedure che sono significativi a MCS. Il termine significativo significa 
che è stato trovato un carattere nel record che viene analizzato corrispondente ad 
un carattere nella tabella di conversione usata. In relazione alla posizione del carat- 
tere nel record, il MCSCU può o non può essere in grado di modificarlo. Il MCSCU 
non può eseguire una conversione automatica completa dell'intero recerd in tutti 
i tipi di membri di libreria. Per esempio, se esiste la seguente specifica OCL in una 
procedura: 


//LOAD $ABC 


Il segno del dollaro ($) è un carattere sensibile a MCS (in alcune lingue), ma non 
può essere automaticamente convertito poichè $ABC è il nome del programma. 
Un altro esempio è dato dai nomi dei formati video ICF che iniziano con $$ e 
non devono essere cambiati. Occorre esaminare le specifiche risultate significative 
per determinare se è desiderabile una modifica manuale o se questa modifica è 
indispensabile. Il MCSCU non elabora i membri oggetto. Questi vengono aggiorna- 
ti quando viene ricompilata l'origine relativa. 


Il MCSCU copia i membri di procedura o origine scelti dall'utente su un file di 
lavoro, esegue l’analisi e aggiorna il file di lavoro e quindi copia di nuovo i mem. 
bri del file di lavoro sulla libreria di emissione specificata. 


Occorre scegliere quali membri di libreria devono essere convertiti. | membri di 
libreria selezionati devono tutti essere dello stesso tipo; ad esempio, RPG, traccia- 
ti video o procedure. Non si devono mescolare tipi di membri nel file di lavoro. 
Per aiutare a scegliere i membri e a creare il file di lavoro, il MCSCU chiede le 
necessarie informazioni. Rispondendo alle richieste nella Figura 34 è possibile: 


e. Ottenere una fista dell'indirizzario di una libreria specificata dalla quale sce- 
gliere i membri. 


e Copiare singoli membri o gruppi di membri da una libreria sul file di lavoro. 
e Eseguire il MCSCU a fronte di un file di lavoro precedentemente creato. 
Occorre usare la lista dell'indirizzario (opzione 1, Figura 34) per ottenere una li- 
sta di tutti i membri di procedura o origine della libreria specificata. Se è instal- 
lato il dispositivo MCS nel Sistema/36, in quei nomi di membri possono compari- 


re caratteri diversi da quelli che l'utente si aspetta di vedere. Se compaiono questi 
nuovi caratteri, occorre immettere quei valori quando si selezionano i membri. 
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E’ una buona idea salvare le procedure e i membri origine su minidisco come 
misura precauzionale. Vedere Procedura SAVELIBR oppure la Procedura FROM- 
LIBR per informazioni sul salvataggio delle librerie o dei membri di libreria, 


La Figura 37 è lo schermo di richiesta per effettuare il processo di selezione. 
Segue lo schermo una spiegazione di ciascuna richiesta e di ciascuna operazione. 


Per prima cosa si copiano i membri da convertire in un file di lavoro. Dopo aver 
copiato tutti i membri di procedura desiderati o i membri origine di un tipo spe- 
cifico, occorre scegliere l'opzione 3 o 4 per eseguire il programma di utilità di 
conversione. 


PROGR. UTILITA' CONVERSIONE GRUPPO CARATTERI MULTINAZIONALI 


Conversione membri origine o di procedura 


Scegliere una delle opzioni: 
1, Indirizzario libreria Ù. Esecuzione 
2, Copia 
3. Copia ed esecuzione 

Opzione 


Nome del membro, nome parziale del gruppo di membri 


oppure per listare tutti i membri, immettere ALL 
Se immess; nome parziale, immettere ALL . 

Tipo membro 

Nome libreria d'immissione 

Nome file di lavoro 


Numero di blocchi per file di lavoro 





Figura 37. Schermo di Copia dei membri di libreria e di conversione 


Scegliere una delle opzioni specifica quale tipo di funzione deve essere eseguita. 
E' possibile immettere 1, 2, 3, 4 o 5. 


1 Lista i nomi di membri origine o di procedura nella libreria specificata. 
Questa lista di indirizzario può essere usata per selezionare i membri per 
la conversione. Dopo la lista, viene ripresentato lo schermo di richieste 
di copia dei membri di libreria. 


2. Copia i membri selezionati sul file di lavoro specificato. Non esegue però 
immediatamente il programma di utilità di conversione. Dopo la copia, 
viene ripresentato lo schermo di richiesta di copia dei membri di libreria 
per consentire di immettere altri membri da copiare sul file di lavoro. 


3. Copia i membri selezionati sul file di lavoro specificato ed esegue il pro- 
gramma di utilità di conversione. Vedere Modifica dei membri di libreria. 


4 Esegue il programma di utilità di conversione usando il file di lavoro 
specificato. Vedere Modifica dei membri di libreria. 


5 Termina lo schermo di conversione dei membri di libreria. 


Nome del membro, nome parziale del gruppo di membri consente di immettere un 
nome membro specifico o un nome parziale di un gruppo di membri da co- 
piare. Questa entrata è richiesta per le opzioni 2 e 3. Se viene immesso ALL, 
tutti i membri di procedura o origine nelle librerie vengono copiati sul file di 
lavoro. Se viene immesso ALL, occorre assicurarsi che tutti i membri origine 
nella libreria siano dello stesso tipo. 


Se immesso nome parziale, immettere ALL: Occorre immettere ALL per ottenere 
una copia di gruppo. Viene ignorato qualsiasi cosa diversa da ALL. Questo 
parametro è ignorato se viene immesso ALL come membro specifico o come 
parametro di nome parziale. 


Tipo membro specifica se devono essere copiati nel file di lavoro membri origine 
o membri di procedura. Questa entrata è indispensabile per le opzioni 1, 2 e 3. 


P indica un membro di procedura. 


S indica un membro origine. 


Nome libreria d’immissione specifica la libreria dalla quale i membri devono essere 
copiati. La libreria assunta per difetto è quella di sessione. Questa entrata è ri- 
chiesta per le opzioni 1, 2 e 3. 


Nome file di lavoro specifica il file di lavoro che, per le opzioni 2 e 3, conterrà i 
membri copiati. Per le opzioni 3 e 4, ciò specifica il file di lavoro che contiene 
i membri di libreria da analizzare ed elaborare. Se il file esiste già, su di esso 
vengono copiati i membri addizionali. Questa entrata è indispensabile per le 
opzioni 2,3 e 4. 


Numero di blocchi per file di lavoro specifica, se il file deve essere allocato, la di- 
mensione del file di lavoro in blocchi. Il valore assunto per difetto è 100 bloc- 
chi. Ciascun blocco può accogliere circa 21 record. 


Se il file di lavoro è troppo piccolo, viene automaticamente esteso quando si 
riempie. 
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MODIFICA DI MEMBRI DI LIBRERIA 


Dopo aver selezionato i membri di libreria da convertire e averli copiati sul file di 
lavoro MCSCU, occorre specificare le informazioni particolarmente legate al 
modo in cui il file di lavoro deve essere analizzato. Le informazioni richieste es 
comprendono: La 


e Quale tipo di membro origine o di procedura si trova nel file di lavoro. 
e iInquale libreria i membri modificati devono essere copiati. 

e Quale tabella di conversione di lingua nazionale deve essere usata. 

e Qual'è la direzione della conversione. 


— . Da lingua nazionale a MCS 
— Da MCSa lingua nazionale 


e Quali tipi di opzioni di analisi sono desiderate. 


Vengono richieste queste ulteriori informazioni di analisi dallo schermo presenta- 
to in Figura 38. Dopo lo schermo segue la descrizione di ciascuno dei tipi di in- 
formazioni di analisi. 


CONVERSIONE GRUPPO CARATTERI MULTINAZIONALI 


Scegliere tipo membro nel file: 
1. RPG + Tracciato video 
2. Procedura . Specifica di selezione 
3. Membro messaggi 
4. Menù 
Nome libreria d'emissione 
Lingua nazionale 


Opzione di conversione. . l-nazionale in MC5,2-MCS in nazionale 


Lista record significativi? . . 06606060606 000040 Y,N 


Conteggio numero record significativi?. . ./.0.... 0. + Y,N 


Variazione record significativi?. . . 


Figura 38. Informazioni di analisi dei membri di libreria 


Scegliere tipo membro nel file: indica il tipo di membri di libreria contenuti nel file 


di lavoro. Può éssere immesso un numero da 1 a 8. Questa opzione esegue le 
funzioni di lista, conteggio e modifica (descritte più avanti) richieste per tutti 
i caratteri in ciascun record. Questa entrata è indispensabile. ll valore assunto 
per difetto è 2, membro di procedura. 


1 Membro origine RPG. 


2. Membro di procedura. 


3. Membro origine messaggi: 

4. Membro origine menù creato dalla procedura BLDMENU. 

5 Membro origine tracciato video. Inoltre, menù creati dal programma di 
utilità SDA. 

6 Membro origine specifiche di Sort. 


7 Membri origine WSU. 


8 Qualsiasi altro membro origine (COBOL, FORTRAN e così via) non 
supportato da un'opzione specifica di tipo di membro. 


Nota: Eseguendo la funzione di copia, il MCSCU non ha bisogno di conosce- 
re il tipo di membro origine che viene selezionato. Ma affinchè il MCSCU 
possa eseguire l'analisi dei membri nel file di lavoro (essendo sensibile ai diversi 
tipi di istruzioni), occorre specificare questa informazione. 


Nome libreria d'emissione specifica il nome della libreria in cui il file di lavoro deve 


essere copiato dopo la conversione. Questa funzione di copia si verifica soltan- 
to se si sceglie di modificare le specifiche significative. Si tratta di un'entrata in- 
dispensabile quando si specifica Y (yes) alla richiesta di modifica dei record 
significativi. 


Lingua nazionale specifica il gruppo di lingua (NLV) richiesto dalla seguente lista: 


USA Stati Uniti e Canada 
BELGIUM Belgio 

BRAZIL Brasile 

CANADA Canada (francese) 
DENMARK Danimarca e Norvegia 
FINLAND Finlandia e Svezia 
FRANCE Francia 

GERMANY Germania e Austria 
ITALY Italia 

JAPAN Giappone (inglese) 
PORTUGAL Portogallo 

SPAIN Spagna 

SPANISH Paesi di lingua spagnola 
UK Regno Unito 

OTHER Fornito dall'utente 


Questa entrata è indispensabile. Il MCSCU fornisce le tabelle di conversione per 
ciascuna lingua nazionale. Se si vuole fornire una propria tabella, occorre farlo 
completando i messaggi del membro messaggi MCSCU (#MN=M2) previsto per 
questo scopo. Quando viene selezionato OTHER, vengono usati i messaggi in 
#MN#M2. Vedère Tabelle di conversione per ulteriori informazioni. 
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Opzione di conversione. ll MCSCU consente la conversione da NLV a MCS median- 
te l'opzione 1 o da MCS a NLV mediante l'opzione 2, Questa entrata è indi- 
spensabile. Il valore assunto per difetto è l'opzione 1. 


Lista record significativi? \| MCSU lista le specifiche, nell’ambito di un membro, che 
contengono caratteri significativi. L'opzione Y è listare; l'opzione N non è lista- 
re. ll valore assunto per difetto è Y. Vedere Lista di membri di libreria MCSCU 


per uiteriori informazioni. 


Conteggio memoria record significativi? MCSCU conta i numeri di specifiche signifi 
cative in un dato membro e il numero totale per tutti i membri nel file di lavo- 

ro. L'opzione Y è contare, l'opzione N non contare. lì valore assunto per difetto è 
Y..Vedere Lista dei membri di libreria MCSCU per ulteriori informazioni. 


Variazione record significativi? MCSCU modifica le specifiche man mano le esamina 
o le lascia così come stanno. L'opzione Y è modificare; l'opzione N è non mo- 
dificare. ll valore assunto per difetto è N. Vedere Modifica specifiche libre- 
ria per una spiegazione di cosa significa modifica per ciascun tipo di membro 


Il MCSCU per i membri di libreria consente di: 
1. Ottenere una lista di controllo di tutti i membri esaminati nel file su disco. 


2. Ottenere una lista delle specifiche in un membro di procedura o origine che 
hanno caratteri significativi a MCS. 


3. Contare tutti i record significativi di un membro o del file. 
4. Modificare le specifiche origine basate sul tipo di specifica. 


Nota: Questo programma di utilità di conversione non deve essere eseguito a 
fronte di qualsiasi membro messaggi, di tracciato video o di procedura fornito dal 
programma su licenza o SSP del Sistema/36. 


Se si indica non listare, non contare e nori modificare, viene emesso un messaggio 
di errore. 


Il programma che esegue l’analisi effettiva del file di lavoro e ia modifica è un 
programma evocato. Ciò consente al programma di conversione di riportare im- 
mediatamente il controllo alla procedura MCSCONV per richiedere ulteriori atti- 
vità di conversione. Pertanto è possibile avere parecchi e diversi file di lavoro che 
vengono analizzati e modificati contemporaneamente. Poichè l’analisi e la modi- 
fica del file di lavoro è ancora in corso, non devono essere copiati ulteriori mem- 
bri sul file di lavoro nè il file di favoro deve essere cancellato fino a che il lavoro 
richiamato non è stato compietato. 


Pagnini. 
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Tabelle di conversione 


Tutte le tabelle di conversione per gruppi di lingue valide sono fornite nel mem- 
bro di messaggio MCSCU =MN#M1. Queste tabelle consentono di passare da uno 
specifico gruppo di lingue a MCS e viceversa. Due ulteriori messaggi nel membro 
di messaggi MCSCU #MN#M2 consentono di fornire proprie tabelle dì conversio- 
ne per la conversione da e verso le varie lingue. Se si desidera fornire la proprie 
tabelle: 


e Modificare i messaggi specificati nel membro messaggi origine denominato 
#MN#M2 usando il SEU (il membro è contenuto nella libreria di sistema 
denominata #LIBRARY) oppure creare un nuovo =MN=M2 usando il 
$MAINT. 


e Usare il seguente linguaggio di controllo operativo per ricostruire il membro 
di messaggi MCSCU =MN=M2: 


// LOAD $MGBLD 











// RUN 
// MGBLD SOURCE-#MN#M2,SSP-YES,REPLACE-YES,LIBRARY-xxx 
// END 


dove xxx identifica la libreria contenente il supporto MCSCU. 


Ci sono due messaggi nel membro di messaggio =MN=M2. Il messaggio numero 
0001 consente di definire la tabella di conversione per passare da NLV a MCS e 
il messaggio numero 0002 viene usato per passare da MCS a NLV. Occorre im- 
mettere coppie contigue di valori da-a. Il messaggio 0001, nell'esempio che segue, 
consente di passare da $ a <, da $a {,eda=a }. 


0001 &<${#} 
Per la conversione inversa, il messaggio 0002 sarebbe 


0002 <6{$}# 


=MN=M2 è un membro di messaggio di secondo livello ed ammette 112 coppie 


di valori di partenza e di arrivo (valori ‘’da’’ e valori ‘’a’”’). La prima posizione 
in bianco da nel messaggio è la fine della tabella. 


Per ulteriori informazioni sulla conversione di caratteri, vedere Cinghie di stampa 
3262. 


Lunghezza specifica origine 
E' posibile avere diverse lunghezze di specifiche origine nella libreria che variano 
in base al tipo di specifica. Quando il MCSCU copia i membri dalla libreria sul 


file di lavoro, tutte le specifiche avranno una lunghezza di 120. Ciò può ampliare 
il fabbisogno di spazio della libreria. 
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LISTA DEI MEMBRI DI LIBRERIA MCSCU 


Segue ora una lista campione prodotta dal MCSCU per un membro di libreria: 


REC NUM 1ircro0e10r rare 00020 rea re re 3Os sese 00 0A0r serre re Or rea 0000010007001 00 0001010100900 0001001000000000110000 0100120 AG 
mat (E MEMBER NAME-MCSTEST , © LIST-(Y), = COUNT-(Y}, = MODIFY-(N}, = DATE-10/24/82, TIME-11118118 
G_: pu First Line! € (cent syabol) 


CBIAA 19997 4 4889A AA9899S 
69923 3955A A DISSI 2042630 


G_ 


*x D è» © 


2 OLD Second Line: (Logical or symbol) 


» 


EBB998 18987 499889889 99 AA98995 
253654 3955A FO D36479313 69 284263D 
NEW I 
4 
F 
* 


3 OLD Third Linei (exclamation point) 


' 
E8998 D0987 5 484999984899 998905 
39994 3955A A IS7331413965 769530 
NEW J 
y 
À 
* 


d 


4 OLD Fourth Line: {iegical not syhbol) 


CPAPAB DEP97 G 49988899 99A AA9899S 
664939 3955A FO D3679313 563 204263) 
NEW Gi 
5 
F 
* 


nad (MEMBER NAME-MCSTEST , = COMPLETE,  COUNT- 4 


TOTAL SENSITIVE RECORD COUNT- 4 


Figura 39. Lista campione dei membri di libreria MCSCU 
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Una riga di controllo contenente il nome del membro e le opzioni attive vie- 
ne listata con le specifiche significative nel membro. LIST, COUNT e MODIFY 
indicano .Y o N in base alle risposte dello schermo di richiesta. La riga di 


controllo è stampata indipendentemente dal fatto che venga selezionata que- 
sta opzione di lista. La riga di controllo è utile come storia di: 


e Quali membri sono stati elaborati nel file di lavoro 
e Quali opzioni di elaborazione sono state richieste 


In caso di ripristino, è possibile determinare i membri che devono essere ela- 
borati visualizzando il file ed eliminando quelli sulla lista di controllo {dopo 
averli copiati sulla libreria di emissione). Se compare la parola PARTIAL in- 
vece di COMPLETE, ciò indica che il file di lavoro non era sufficientemente 
ampio per contenere l'intero membro quando è stata eseguita la copia della 
selezione dei membri. Verrà emesso un messaggio dal $SMAINT quando il file 
di lavoro è copiato di nuovo sulla libreria. Occorre ricopiare il membro par- 
ziale su un nuovo file di lavoro e rielaborare l’intero membro. 


Indicatori di colonna aiutano a determinare la colonna in cui è stato trovato 
il carattere significativo. 


Il numero della istruzione nell’ambito del membro che viene elaborato. 


OLD indica la specifica originale. La specifica è stampata in formato caratte- 
re e in formato esadecimale. 


NEW indica che la specifica conteneva caratteri significativi. | caratteri signifi- 
cativi hanno i dati stampati al di sotto della specifica originale. | caratteri stam- 
pati sulla riga NEW indicano dove si trovavano i dati significativi. 


Viene anche presentato il nuovo carattere significativo. Se si sceglie l'opzione di 
non modificare le specifiche significative, i vecchi e i nuovi caratteri saranno 
uguali. Se si sceglie l'opzione di modificare le specifiche significative. 


e Se il carattere è in una posizione che il MCSCU può modificare, viene 
stampato il nuovo carattere sostituito. 


e Se il carattere è in una posizione che il MCSCU non può modificare {per 
esempio, davanti al nome di un programma), viene stampato il carattere 
originale. 


Vengono stampati il carattere (se la stampatrice lo consente) e il suo valore 
esadecimale. Viene stampato un asterisco (*) al di sotto di ciascun carattere 
della riga NEW significativo ma non modificato. 


Ii numero delle specifiche in un membro che erano significative al MCS. Mostra 
anche tutte le specifiche nell'intero file di lavoro che sono significative a MCS. 


837 


838 


MODIFICA DELLE SPECIFICHE DI LIBRERIA 


Sulla base del tipo di membro che viene elaborato, il MCSCU diventa sensibile ai 
diversi tipi di specifiche nell'ambito di un membro origine. Talune colonne e ta- 
luni campi possono essere modificati e taluni possono essere soltanto indicati con 
un asterisco (*). Ciascuna delle seguenti sezioni descrive l'attività che viene ese- 
guta per ciascun tipo di specifica. Se nell’ambito di un dato membro si incontra 
una specifica che non soddisfa criteri per quel tipo di origine, i dati significativi so- 
no indicati ma non modificati. Per esempio, una Z nella colonna 6 dell'RPG non è 
valida e la specitica verrebbe analizzata ma non modificata. 


Nota: Il MCSCU suppone che i membri da elaborare siano validi per quanto ri- 
guarda la sintassi e che siano accettati dal programma su licenza o SSP del Siste- 
ma/36 che normalmente li userebbe. 


Membri origine RPG 


Se le colonne 1 e 2 contengono asterischi (**), in tal caso tutte le specifiche per 
quel membro che seguono il record ** sono analizzate ma non modificate. Due 
asterischi indicano una tabella a tempo di compilazione o i dati di una schiera, 
sequenza alternativa e tabella di conversione dei file, 


Se la colonna 7 contiene un singolo asterisco (*), tutte le colonne vengono ana- 
lizzate e vengono modificati i caratteri sensibili. 


Se la colonna 6 contiene una H: 


e Le colonne da 1 a 74 vengono analizzate e vengono modificati i caratteri 
significativi. 

e La colonna 18 ha il simbolo mobile del dollaro inserito dalla tabella di con- 
versione se (1) la colonna 18 è vuota; (2) la tabella di conversione contiene 
un esadecimale 5B in un valore di confronto ‘’da’’; e (3) si sta convertendo 


da NLV a MCS. Quando si sta convertendo da MCS a NLV, la colonna 18 
sarà in bianco. Tutte le tabelle da NLV a MCS fornite col MCSCU hanno un 


detti > 


valore esadecimale 5B quando il valore ‘‘a’’ è diverso da esadecimale BB. 
e Le colonne da 75 a 80 sono soltanto indicate. 
Se la colonna 6 contiene una F: 
e Vengono analizzate tutte le colonne. 
e dati sono soltanto indicati. 
Se la colonna 6 contiene un I: 


e Le colonne da 27a41 sono analizzate e i caratteri significativi vengono modifi- 
cati. 


° Le altre colonne sono soltanto indicate. 


SETA: 


En 


Se la colonna 6 contiene una C: 

e Tutte le colonne sono analizzate e indicate. 

e Le colonne da 18 a 27 e da 33 a 42 sono modificate se la colonna 18 0 33 
contiene un apice (’) indicante una costante. 

Se la colonna 6 contiene una O; 

e Tutte le colonne vengono analizzate e indicate. 


e Le colonne da 45 a 70 sono modificate se le colonne da 40 a 43 non con- 
tengono una K seguito da un numero (allineato a destra) da 1 a 8, che in- 
dica un nome di formato, 


Se la colonna 6 contiene una L, una E, una T un U, i record sono soltanto ana- 
lizzati e indicati. ì 


Se, iniziando dalla colonna 7, il MCSCU individua un /COPY, /SPACE, /EJECT o 
ITITLE, ie specifiche sono solo indicate. 


Membri di procedura 


Quando viene rilevato un carattere significativo MCS tutte le specifiche sono indica- 
te. Vengono modificate soltanto le seguenti specifiche OCL: 


e Le specifiche di commento in una procedura sono modificate completamen- 
te. Un commento è indicato da un asterisco (*) nella colonna 1. 


e //*, //**, /IMSG e //PAUSE con testo hanno il testo dei messaggio e qualsia- 
si commento modificati. 


e Per qualsiasi specifica che non inizia con ‘//, vengono analizzate e indicate 
tutte le colonne. ° 


Nota: Poiché il file di lavoro è un file nel modo a record, il programma di utilità 


$MAINT ha inserito una specifica COPY prima di ciascun membro nel file e una. 


specifica CEND dopo ciascun membro. Se si dispone di una procedura che con- 
tiene specifiche interne CEND, la CEND interna termina prematuramente l’elaio- 
razione della procedura per quei membro. Essa può inoltre provocare una stampa 
non corretta della riga di controllo. Le specifiche interne CEND sono valide nelle 
procedure degli utenti soltanto quando viene specificato FROM-READER dal 
$MAINT. 
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Membri di messaggi 


Tutte le specifiche in un membro sono esaminate ed elaborate nel modo seguente: 
e Tutti i commenti sono analizzati e modificati. 
e La specifica di controllo nel membro è soltanto indicata. 


e Tutte le specifiche di definizione messaggi sono analizzate e modificate, 


Il programmatore Assembler dovrebbe essere consapevole che i messaggi indicanti 
sostituzione di caratteri mediante # che usano il programma di utilità di visualiz- 
zazione messaggi ($CPPE) avranno i rispettivi contenuti modificati se # ha uh va- 
lore alternativo MCS da NLV. 


Membri dei menù 


Si suppone che i membri di menù debbano essere creati dalla procedura 
BLDMENU. Questi membri di menù sono trattati allo stesso modo dei membri 
di messaggio. Se il membro di messaggio di comandi per un menù contiene OCL, 
i dati sensibili vengono modificati. 


I menù possono anche essere creati usando il programma di utilità SDA. | mem- 
bri origine di testi SDA sul Sistema/36 sono membri origine tracciato video ma 
non membri origine di messaggi. (I membri origine di messaggi sono usati dalla 
procedura BLDMENU). Per determinare il tipo di membro origine usato per crea- 
re il menù, listare il membro usando la procedura LISTLIBR (vedere la Procedura 
LISTLIBR per informazioni sull'esecuzione di LISTLIBR). Se il membro contiene 
specifiche S— e D—, si ritiene creato da SDA e occorre usare l'opzione 5 per con- 
vertirlo. 


Per ulteriori informazioni sui menù, vedere il manuale Guida alla definizione dei 
tracciati video. 


Tracciati video: 
Tutti i commenti sono analizzati e i caratteri significativi vengono modificati. 


Se la colonna 6 contiene un S, H o D: 

e Vengono indicate le colonne da 7 a 14. 

e Tutte le altre colonne sono analizzate e vengono modificati i caratteri significa- 
tivi. 


e Vengono modificate le colonne da 7 a 14 della specifica D continuata. 


Membri di selezione 


Tutte le specifiche nel membro sono soggette a modifica salvo la specifica 
ALTSEO.. Il MCSCU indica soltanto i caratteri significativi nelle specifiche ALT- 
SEO. 


WSU 


a 
Se la colonna 7 contiene un asterisco (*) indicante un commento, tutte le colon: 
ne saranno analizzate e i caratteri significativi verranno modificati. 
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Se la colonna 6 contiene un J, T o M, tutte le colonne sono analizzate e i dati 
significativi vengono indicati. 


Se la colonna 6 contiene una S o una D, la specifica è la stessa dei tracciati video. 


Se la colonna 6 contiene una C o una E, la specifica viene elaborata come le spe- 
cifiche RPG C o E descritte precedentemente, Inoltre, saranno modificati IMSG, 
MSG e i codici operativi di una tabella di confronto che hanno dati significativi tra 
apici ("). 


Altro tipo di specifica 


Se il membro origine non è identificato univocamente da un'opzione precedente- 
mente descritta, può essere usata questa opzione, che analizza tutte le specifiche 
nel membro e modifica qualsiasi carattere significativo MCS che viene rilevato quan- 
do viene selezionata la modifica. 


COPIA NELLA LIBRERIA 


Quando il programma di conversione è completo, il file di lavoro viene ricopiato 
nella libreria di emissione specificata se era stata selezionata la funzione di mo- 
difica. E' responsabilità dell'utente assicurarsi che la libreria di emissione sia suf- 
ficientemente ampia per contenere tutta l'origine convertita. Il programma di uti- 
lità di conversione usa il programma di utilità SMAINT per copiare il file di lavo- 
ro nella libreria. 


ULTERIORI CONSIDERAZIONI SUI MEMBRI DI LIBRERIA 


Il MCSCU copia i membri di libreria su un file di lavoro, modifica i membri nel 
file di lavoro e quindi li ricopia nella libreria di emissione specificata. Poiché al- 
cune specifiche di membri di libreria non possono essere totalmente modificate 
dal MCSCU, deve essere eseguito un qualche esame manuale dei risultati dell'op- 
zione LIST. Qualsiasi modifica manuale deve essere effettuata usando il SEU. | 
membri che richiedono ricompilazione o rigenerazione (ad esempio RPG, COBOL, 
FORTRAN, Assembler, DFU, membri di messaggio, tracciati video, WSU e mem- 
bri di menù) devono essere ricompilati. Quando si è terminato di eseguire il 
MCSCU a fronte di un qualche lavoro, occorre cancellare il file di lavoro usando 
il comando di procedura DELETE. 


Se la libreria di emissione si riempie mentre viene copiata l'origine modificata 
nella libreria dal file di lavoro, occorre procedere come segue: 


e Riallocare la libreria di emissione per renderla più ampia. 


e Immettere le seguenti specifiche OCL, per copiare di nuovo il file di [lavoro 
sulla libreria di emissione: 


// LOAD $MAINT 

// FILE NAME-xxx 

// RUN 

// COPY FROM-DISK,TO-yyy,FILE-xxx 
// END 


dove xxx è il nome del file di lavoro e yyy è il nome della libreria di emissione. 
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CONVERSIONE DEI FILE SU DISCO 


| file di dati possono contenere caratteri che hanno assunto un nuovo valore esa- 
decimale sotto MCS. Quando un programma visualizza o stampa queste aree di 
dati, viene visualizzato il carattere associato con il valore MCS invece del caratte- 
re associato con il valore della versione della lingua nazionale (NLV). IT MCSCU 
aiuta a trovare i dati dei record che sono significativi a MCS. Occorre far attenzione 
per evitare che il MCSCU modifichi campi di dati contenenti valori binari o com- 
pressi che potrebbero apparire significativi a MCSCU. 


Se si sceglie la conversione del file di dati, compare lo schermo di richiesta indi- 
cato in Figura 40. Segue lo schermo una descrizione di ciascuna richiesta. 


CONVERSIONE GRUPPO CARATTERI MULTINAZIONALI Facolt.-* 


Conversione file di dati 


Valore iniziale di scansione. . « + 9001-3096 


Valore finale di scansione. . . . . + 0. + + 0001-4096 


Lingua nazionale 

Opzione di conversione. . l-nazionale in MCS,2-MCS in nazionale 
Lista record significativi? . .... + 

Conteggio numero recor4 significativi? 


Variazione record significativi? . L60668. 





Figura 40. Conversione dei file di dati 


Nome file specifica il file di dati da convertire o da esaminare. Questo valore è indi- 
spensabile. Se viene immesso un nome illecito, si verifica un errore. 


Data di creazione del file specifica la data di creazione a 6 cifre per questo file se 
occorre una distinzione tra i file con fo stesso nome. 


Valore iniziale di scansicne: Se si desidera che il record venga analizzato o modifica- 
to entro certe posizioni del record, è possibile indicare il valore della posizione 
iniziale. Il valore deve essere maggiore di zero e minore di o uguale alla lun- 
ghezza del record. Il valore assunto per difetto è 1. 


Valore finale di scansione: E' possibile indicare il valore finale per la scansione entro 
i limiti. Il valore deve essere maggiore di o uguale al valore di scansione iniziale 
e deve essere minore di o uguale alla lunghezza del record. il valore assunto per 


difetto è l’ultimo byte del record. 
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Lingua nazionale specifica il gruppo di lingua richiesto, scelto dalla lingua seguente: 


USA Stati Uniti e Canada 
BELGIUM Belgio 

BRAZIL Brasile 

CANADA Canada (francese) 
DENMARK. Danimarca e Norvegia 
FINLAND  Finalandia e Svezia 
FRANCE Francia 

GERMANY Germania e Austria 


ITALY Italia 

JAPAN Giappone (inglese) 
PORTUGAL Portogallo 

SPAIN Spagna 

SPANISH — Paesi di lingua spagnola 
UK Regno Unito 


OTHER Forniti dall'utente 


Questa entrata è obbligatoria. Il! MCSCU fornisce le tabelle di conversione 
per ciascuna delle lingue nazionali. Se si desidera fornire proprie tabelle, è 
possibile farlo completando il messaggio nel membro di messaggi MCSCU 
(XMN#M2) previsto per questo scopo. Quando viene selezionato OTHER, 
vengono usati i messaggi in #MN#M2. Vedere Tabella di conversione. 


Opzione di conversione: Il MCSCU consente la conversione dalla lingua nazionale 
NLV) a MCS mediante l'opzione 1 o da MCS alla lingua nazionale (NLV) me- 
diante l'opzione 2. Il valore assunto per difetto è l'opzione 1. 


Lista record significativi? specifica se il MCSCU deve listare record che contengono 
caratteri significativi. L'opzione Y è listare; l'opzione N è non listare. Il valore 
assunto per difetto è Y. Vedere Lista dei file su disco MCSCU per ulteriori 
informazioni. i 


Conteggio numero record significativi? Specifica se il MCSCU deve contare il nume- 
ro dei record nel file che contengono caratteri significativi. L'opzione Y è con- 
tare; l'opzione N è non contare. Il valore assunto per difetto è Y. Vedere L/sta 
dei file su disco MCSCU per ulteriori informazioni. 
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Variazione record significativi? Specifica se il MCSCU deve modificare i record man 
mano che li esamina o lasciarli così come sono. L'opzione Y è modificare; l'op- 
zione N è non modificare. il valore assunto per difetto è N. Vedere Modifica 
file su disco per un'ulteriore spiegazione di cosa significa modifica per i file. 


Il MCSCU determina automaticamente il tipo di file (a indice, sequenziale o di- 
retto) ed esegue la modifica di conseguenza. 


Come cori i membri di libreria è possibile far sì che il MCSCU: 
e Listai record significativi a MCS nel file 

e Contii record significativi a MCS nel file 

e  Modifichii record significativi a MCS nel file. 


Ci sono le stesse opzioni previste per la conversione dei membri di libreria in ter- 
mini di: 


e Determinazione del gruppo di lingua da convertire 

e Conversione da nazionale a MCS 

e Conversione da MCS a nazionale 

e Fornitura di una propria tabella di conversione. 

Fare riferimento a Modifica dei membri di libreria per una spiegazione. 


La conversione dei dati è un'operazione di aggiornamento da eseguirsi sul posto. 
Il file non viene scritto su un file intermedio. Si consiglia di salvare i file prima 
di iniziare fa conversione. Vedere la Procedura SAVE per informazioni sul salva- 
taggio dei file. 


Il MCSCU determina automaticamente il tipo di file (sequenziale, a indice o di- 
retto) che ‘era stato selezionato e altri attributi relativi al file tipo lunghezza re- 
cord, lunghezza ‘chiave e iocazione chiave. Se si sceglie di non listare, di non con- 
tare e di non modificare, viene visualizzato un messaggio, 


Se i limiti della scansione sono illeciti, viene visualizzato un messaggio di errore 
e il MCSCU termina. 


Il programma che esegue l’analisi e la modifica effettiva del file di lavoro è un 
programma evocato. Ciò consente al programma di conversione effettivo di venir 
eseguito come lavoro separato e consente di riportare immediatamente il control- 
lo alla procedura MCSCONV per richiedere ulteriore attività di conversione. Per- 
tanto è possibile avere parecchi file di lavoro diversi che vengono analizzati e mo- 
dificati contemporaneamente. Poiché l’analisi e la modofica del file di lavoro è 
ancora in corso, non devono essere copiati ulteriori membri sul file di lavoro al- 
trimenti questi potrebbe non venir cancellato fino a che il lavoro richiamato non 
è stato completato. 


Lista dei file su disco MCOSCU 


Segue ora una lista campione prodotta per un file di dati: 


REC NU 1irerr0ei0erer00e02Orroe000030se 000000 40r e rere re Os ere erede errore 70r ere 0000800000 000090000000 0100 AD 
GO_FILE NAME-MESTEST ,  LIST-(Y),  COUNT-(Y), - MODIFY-(N}, START SCAN- 1, END SCAN- 80, DATE-10/24/82, = TIME-11124143 
G_-2 ap  FirstLine: € (cent syabol) 


CBIAA4N99074444444099/A4AA9999744444444444444444444444440444404444444444444444444 
69923037FZA00A000NIZZI02842631N00000000000000000000000000000000000000000000000000 


G_ 


* D a a» 


3 OD Second Limet | ({logical or synbol): 
EB89984NG98744444499988994994AA9999544444444444444444444444444444444444444444444 
PIGISLSANIPSZAOF 0001136 7931 3049029424 3D00000000000000000000000000000000000000000000) 


NEW Ì 
4 
F 
* 

4 OLD Third Linet | (exclamation point) 
E889841998744544448A8989BAB9949987A744444444444444444444444444444444444444444444 
39994039 5540000005 73314139650 75953D000000000000000000000000000000000000000I000) 

NEW : 
5 
à 
* 

5 OD Fourth Line! © (logical not syabol) 
C9A9AG4I89874544449988889499A4AA99995/4444444444444444444444444444444444444444444 
6649IBIIPSDAONF 0001136 7931 305430294263N00000000000I000000000000I0CINAACIINC0000000 

NEW S 
F 
* 
G@_FILE NAEMESTEST , COMPLETE, COUNT- 4 


Figura 41. Lista campione del file di dati MCSCU 


O Viene listata una riga di coftrolio contenente il nome del file le opzioni at- 
tive nonché con i record significativi. LIST, COUNT e MODIFY indicano ri- 
spettivamente Y o N in base alla risposta allo schermo di richiesta. 


(8) Gli indicatori di colonna aiutano a determinare la colonna in cui è stato tro- 
vato un carattere significativo. 


0 Il numero relativo del record nell'ambito del file che viene elaborato. 


[D) OLD indica i record originali. Il record è stampato in formato carattere e for- 
mato esadecimale. 
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0 NEW indica il record contenente i caratteri significativi. | caratteri significativi 
hanno i dati stampati al disotto del record originale. | caratteri stampati sulla 
riga NEW indicano dove sono stati trovati dati significativi. 


Viene anche presentato il nuovo carattere significativo. Se si è scelto N alla ri- 
chiesta di modifica, il carattere nuovo e quello originale saranno uguali. Se si 
è scelto Y alla richiesta di modifica: 


e Se si tratta di una posizione di record che il MCSCU può modificare, 
viene stampato il nuovo carattere sostituito. 


e Se si tratta di una posizione di record che il MCSCU non può modificare 
(nell'indice, al di fuori dei limiti), viene stampato il carattere originale. 


Vengono stampati il carattere (se la stampa lo consente) e il suo valore 
esadecimale. Viene stampato un asterisco (*) al disotto di ciascun carattere 


nella riga NEW che era significativo ma che non è stato modificato. 


(F) Il numero di record che erano significativi a MCS. 


MODIFICA DEI FILE SU DISCO 


L'opzione di modifica usa la tabella di conversione specificata; ogniqualvolta tro- 
va un carattere significativo a MCS sostituisce il valore alternativo. La sola eccezione 
è che il MCSCU non modifica il campo chiave di un file a indice ma indica soltanto 
i dati significativi a MCS nel campo chiave. Occorre quindi usare i valori di limite 
di scansione per evitare di far sì che il MCSCU elabori accidentalmente campi bi- 
nari e compressi che potrebbero contenere quelli che potrebbero apparire come ca- 
ratteri significativi. Lo stesso vale per i campi per i file diretti nei cui confronti 
viene usata una tecnica specifica per allocare i sinonimi. Se MCSCU cambia il va- 
lore in un campo che viene sottoposto alla suddetta tecnica, viene modificato il 
modo in cui il programma viene eseguito. 


Se occorre convertire dei file a indice: 


e Copiare il file a indice su un file sequenziale sotto un nuovo nome file. Ve- 
dere la Procedura COPYDATA per informazioni sulla copia dei file di dati. 


e Eseguire il MCSCU a fronte del file sequenziale. 


e Cancellare il file a indice originale. Vedere la Procedura DELETE per infor- 
mazioni sulla cancellazione dei file di dati. 


e Copiare il file sequenziale su un nuovo file con il nome file originale e con 
gli attributi (a indice, posizionamento chiave, locazione chiave e così via). 
Vedere la Procedura COPYDATA per informazioni sulla copia dei file di dati. 


Pesi 


INTERFACCIA BATCH 


Se si desidera impostare una procedura a blocchi per convertire membri di libre- 
ria o file, è possibile farlo. Si può far ciò per un'installazione a locazioni multi- 
pie in modo da essere in grado di avere un programmatore nella locazione X che 
stabilisce le procedure per le locazioni X, Y e Z. 


Nota: Quando si esegue il MCSCU con un'interfaccia a blocchi, il programma ese- 
gue l’analisi effettiva del file di dati o del file di lavoro e le modifiche non vengo- 
no richiamate. Ci sono valori assunti per difetto dei parametri dall'interfaccia a 
blocchi. 


Membri di libreria 


II linguaggio di controllo operativo necessario per eseguire la conversione dei 
membri è: 


e Costruire le OCL per eseguire il $SMAINT e copiare i membri su un file su di- 
sco, La seguente procedura OCL copia dalla libreria ABC tutti i membri ori- 
gine che iniziano con PAY, su un file denominato PAYR con una lunghezza 
di record di 120. Quindi aggiunge membri che iniziano con AR al file PAYR. 


Vedere le Specifiche di procedura FROMLIBR: Programma di utilità 
$MAINT per ulteriori informazioni sulla copia di membri di libreria su file 
record di 120. Quindi aggiunge membri che iniziano con AR al file PAYR. 


// LOAD $MAINT 

// FILE NAME-PAYR,UNIT-F1,BLOCKS-100,RETAIN-T 
// RUN 

// COPY FROM-ABC,TO-DISK,FILE-PAYR,RECL-120 
// NAME-PAY. ALL, LIBRARY-S,SVATTR-YES 

// COPY FROM-ABC,TO-DISK,FILE-PAYR,ADD-YFS, 
// NAME-AR.ALL,LIBRARY-S,SVATTR-YES 

// END 








e Attivare l'indicatore 1 UPSI con la seguente specifica OCL: 
// SWITCH 10000000 


Ciò fa sì che vengono soppressi tutti gli schermi di richiesta; 
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e Avviare la procedura MCOSCU MCSLIB: 


MCSLIB tipo membro,nome libreria d'emissione,lingua,da a,lista, 


conteggio ,variazione,nome file 





tipo membro è un valore da 1 a 8 per un tipo di membro descritto nel Mo- 
difica dei membri di libreria. 


nome libreria di emissione è il nome della libreria sulla quale il file deve es- 
sere copiato. 


lingua è una delle lingue nazionali valide descritte in Modifica membri di 
libreria. 


da a: 1 per la conversione da NVL a MCS, 2 per la conversione da MCS a 
NVL. 


lista: Y per listare record significativi, N per non listarli. 

conteggio: Y per contare i record significativi, N per non contarli. 
variazione: Y per modificare i record significativi, N per non modificarli. 
nome file è il nome del file di lavoro contenente i membri da elaborare. 


Se alcuni parametri non sono corretti, viene visualizzato un messaggio di errore. 


848 


File su disco 
La OCL necessaria per eseguire la conversione di file è: 
e- Attivazione dell'indicatore 1 UPSI con la seguente specifica OCL: 
// SWITCH 10000000 
Ciò fa sì che venga soppressa la visualizzazione delle richieste. 


e Avviare la procedura MCSCU MCSDATA: 


na 
MCSDATA nome file, |mmggaa |,inizio,fine,lingua, da a,conteggio,variazione 


gemma a 


aammE& 





nome file è il nome del file da convertire. 
mmggaa, ggmmaa o aammgg è la data di creazione del file, 


inizio è il valore iniziale di scansione a 4 cifre descritto in Conversione dei file su 
disco. ° 


fine è il valore finale di scansione a 4 cifre descritto in Conversione dei file su. 
disco. 


lingua è una delle lingue nazionali valide descritte in Conversione dei file su 
disco. 


da a: 1 per il passaggio da NLV a MCS, 2 per il passaggio da MCS a NLV. 
lista: Y per listare i record significativi, N per non listarli. 
conteggio: Y per contare i record significativi, N per non contarli. 


variazione: Y per modificare i record significativi, N per non modificarli. 
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Caratteri modificati per gruppi di lingua 


La tabella che segue mostra, per gruppo di lingua, i caratteri del Sistema/36 che 
vengono cambiati con la serie di caratteri multinazionali. La colonna contrasse- 
gnata Vecchio carattere contiene il carattere originale. La colonna contrassegnata 
Vecchio esadecimale contiene la rappresentazione esadecimale originale che deve 
essere modificata nel valore indicato nella colonna contrassegnata Nuovo esadeci- 
male. Se questa conversione non viene eseguita, il nuovo carattere rappresentato 
dal vecchio valore esadecimale viene visualizzato e/o stampato. 


Vecchio Vecchio Nuovo 


carat-  esadeci- esadeci- —Nuovo carattere rappresentato dal vecchio 
tere male (da) male (a) esadecimale (se non modificato) 

Stati Uniti e 0 4A BO C 

Canada: GG #sseeseezentee =ssssseoem@eSmbcsos=seenenoetesazae 
I AF HE . 

SA AR re 

SE e af, Ta ie 

nn —cee@-_—__° _r—_r_—_—__.__—.———.@_ 
Austria/Germania A 4À 53 [ 

OE e eg E 

e A 

ne gi 

BOB SS TA 

BO AR 

RE cene ca I e 

Saar a ge TIT Sen 

tl _————_———m—m@6T———mm’—_@@t1@tt—1t1t—@—&@———___ tr — 
Belgio ù b6i PD 

ae aa O 

RA E 

DA A «a 

Se sà 

Ca 
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Vecchio Vecchio Nuovo 
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Vecchio Vecchio Nuovo 
carat- esadeciì- esadeci- Nuovo carattere rappresentato dal vecchio 
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Vecchio Vecchio Nuovo 
carat-  esadeci- esadeci- Nuovo carattere rappresentato dal vecchio 
tere male (da) male (a) esadecimale (se non modificato) 
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Vecchio Vecchio Nuovo 
carat-. esadeci- esadeci- Nuovo carattere rappresentato dal vecchio 
tere male (da) male (a) esadecimale (se non modificato) 
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2. 


AppendiceE. Cinghie di stampa per stampatrice 3262 


e tabelle di conversione 


Questa appendice elenca i caratteri delle cinghie di stampa e le tabelle di conver- 
sione per la stampatrice 3262 IBM. 


CINGHIE DI STAMPA 3262 


Questa sezione indica tutti ì caratteri disponibili e la cinghia o le cinghie di stam- 
pa sulle quali compaiono i caratteri stessi. Se il carattere è disponibile, viene indi- 
cato un punto (.) sotto il titolo per quella cinghia. Se viene indicato un carattere 
invece del punto, quel carattere corrisponde al valore esadecimale indicato per 
quella cinghia. Se si vogliono informazioni sulle cinghie di stampa diverse da quel- 
le indicate, prendere contatto con il rappresentante vendite IBM. 
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I caratteri sono indicati in sequenza di selezione ascendente; cioè il carattere 
“spazio in bianco” è il più basso (verrà selezionato prima di qualsiasi altro carat: 
tere) e il carattere 9 è il più elevato. 


Carattere 


Spazio in bianco (non rap- 


Equivalente 
Esadecimale 


40 


presentato sulla cinghia di stampa) 


) 


A DIM e ni png Du: DT 


. (punto) 


AD mr dA E + A 
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41 
42 
43 
44 
45 
46 
47 
48 
49 
4A 
48 
4C 
4D 
4E 
4F 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
5A 
5B 
5C 
5D 
SE 


Cinghie di stampa 


. 64 
48 48HN (BELT64B 
(BELT48) (BELT48HN) BELT64C) 


o. 
. . ° 
e 
° ° 
. ° 
. 
° ° ° 
) 
° 
° 


96 
(BELT96) 


188 
(BELT188B) 


e e e e. 0 è 0 e 0 0 e 0 e ®e)|- © oe e e — 0 © © © 0 0 0 © ®© 


Cinghie di stampa 
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62 

63 

64 

65 

66 

67 

68 
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6E 

6F 

70 

71 

72 

73 

74 
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Cinghie di stampa 


64 
Equivalente 48 48HN (BELT64B 96 188 
Carattere Esadecimale (BELT48) (BELT48HN) BELT64C) (BELT96) (BELT188B) 


92 
93 
94 
95 
96 
97 
98 
99 
9A 
9B 
9C i O 
9D 

9E 

9F ° 
AO 
AI 
A2 
A3 
A4 
AB 
AG 
AT 
A8 
A9 
AA 
AB 
AC 
AD 
AE 
AF 
Bo 
BI 
B2 
B3 
B4 
B5 
B6 
B7 
B8 
B9 
BA 
BB 
BC 
BD 
BE 
BE 
Co 
C1 
c2 
C3 
Cc4 
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Cinghie di stampa 


64 
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Esadecimale 


Carattere 
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Carattere 


CN Cr CIC) L 0 
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Cinghie di stampa 


64 
Equivalente 48 48HN — (BELT64B 
Esadecimale (BELT48) (BELT48HN) BELT64C) 


F8 ° ° ° 
F9 D) ©. CD) 
FA 
FB 
FC 
FD 
FE 


96 188 
(BELT96) (BELT188B) 


TABELLE DI CONVERSIONE PER 3262 


Questa sezione indica tutti i caratteri disponibili e i relativi caratteri convertiti. | 
caratteri sono indicati in ordine di selezione ascendente; cioè il carattere ‘’spazio 
in bianco” è il più basso (verrà selezionato prima di qualsiasi altro carattere) e il 
carattere 9 è il più elevato, 


Viene fornita un'altra tabella di conversione denominata #188E188. Questa ta- 
bella disattiva la conversione, La serie di parentesi vuote, specificata da ( ), in- 
dica che il corrispondente codice esadecimale non ha un carattere. 
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Tabella #96E48 


Se è installata la cinghia di stampa carattere BELT48, usare questa tabella per 
avere i caratteri minuscoli stampati come maiuscoli invece di spazi in bianco. 


Da 


Carattere 


19 e nmmne no p_ 4 — =. 


n. — 


Trimmer ee | ]yj 


' 
% 


— — — — — — — — — — — —_—r — ——r-— 


— — — —r  —__ —_—_ 


A 


Codice Carattere 


40 
41 
42 
43 
44 
45 
46 
47 
48 
49 
4A 
48 
AC 
4D 
4E 
4F 
50 
51 
52 
53 
54 
55 
56 
57 
58 
59 
5A 
5B 
5C 
5D 
5E 
5F 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 
6A 
68 
6C 
6D 
6E 
6F 


{ 
{ 
( 
{ 
( 
{ 
( 
( 
{ 
( 
{ 


+DA III PR +- 


re e II i 


L° 


PEPIA 


— — — — —r  —_ ——-——P —_- 


— — — —Pr —— _"—P — — — 


Codice 


40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
4B 
40 
40 
4E 
40 
50 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
5B 
5C 
40 
40 
40 
60 
61 
40 
40 
40 
40 
40 
40 
40 
40 
40 
68 
6C 
40 
40 
40 


Carattere 


2 i i -_ 


779000 35 3F Eee Ze IO +00 


— — — — — — -—- 


— — — — — — 


Da 


A 


Codice Carattere 


70 

71 

72 

73 
74 

75 
76 
77 

78 
79 
7A 
7B 
7C 
7D 
7E 
rin 
80 
81 

82 
83 
84 
85 
86 
87 

88 
89 
8A 
88 
8C 
8D 
8E 
8F 
90 
91 

92 
93 
94 
95 
96 
97 
98 
99 


(fe) 
> 


98 
9C 
9D 
9E 
9F 


( 
( 
{ 
{ 
{ 
{ 
{ 
( 
{ 
{ 
( 


# 
@ 
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Pe I 


—|— — — — — — 


— — — — — -— 


Codice 


40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
7B 
7C 
7D 
40 
40 
40 
CI 
C2 
C3 
c4 
C5 
C6 
C7 
c8 
C9 
40 
40 
40 
40 
40 
40 
40 
DI 
D2 
D3 
D4 
D5 
D6 
D7 
D8 
D9 
40 
40 
40 
40 
40 
40 


Tabella #96E48 (continuazione) 


Carattere 
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) 
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— — — — — — — — — — — — — — — —_ | _ —_ ° —-——-c- 


— — — — — —_ 


Da 


A 


Codice Carattere 


AO 
AI 
A2 
A3 
A4 
AS 
A6 
AI 
AB 
A9 
AA 
AB 
AC 
AD 
AE 
AF 
BO 
BI 
B2 
B3 
B4 
BS 
B6 
B7 
B8 
B9 
BA 
BB 
BC 
BD 
BE 
BF 
co 
CI 
c2 
c3 
c4 
C5 
C6 
C7 
c8 
c9 
CA 
CB 
(oto 
CD 
CE 
CF 


. 
n — — — — 


——_ —_ 


nl — — — e — — — — — — — — — — —|- — — — — — 


Codice 


40 
40 
E2 
E3 
E4 
E5 
E6 
E7 
E8 
E9 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
CI 
c2 
c3 
C4 
C5 
cC6 
C7 
C8 
C9 
40 
40 
40 
40 
40 
40 


Carattere 
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DO 
DI 
D2 
D3 
D4 
D5 
D6 
D7 
D8 
D9 
DA 
DB 
DC 
DD 
DE 
DF 
EO 
EI 
E2 
E3 
E4 
ES 
E6 
E7 
E8 
E9 
EA 
EB 
EC 
ED 
EE 
EF 


SI IINKCXS<CHUT | 77770 VvOZZCACT 


Codise Carattere 


—_— 


40 

DI 

D2 
D3 
D4 
D5 
D6 
D7 
D8 
D9 
40 

40 
40 
40 
40 

40 

40 
40 
E2 
E3 
E4 
E5 
E6 
E7 
E8 
E9 
40 
40 
40 
40 
40 
40 


—AAZIZ7T 0 ON DI APWN- O 


— — — — — 


FO 
FI 

F2 
F3 
F4 

F5 
F6 
F7 

F8 
F9 
FA 
FB 
FC 
FD 
FE 


eZ 5 ONDODUASAWN- O 


— — — — — 


FO 
FI 
F2 
F3 
F4 
F5 
F6 
F7 
F8 
F9 
40 
40 
40 
40 
40 


Codice 


863 


864 


Tabella #96E64 


Se è installata una cinghia di stampa carattere BELT64B o BELT64C, usare que- 
sta tabella per avere i caratteri minuscoli stampati come maiuscoli invece di spa- 





zi in bianco. 

Da A 
Carattere Codice Carattere Codice 
() 40 {) 40 
() 41 {}) 40 
{) 42 () 40 
{ ) 43 {) 40 
() 44 () 40 
{ ) 45 () 40 
() 46 {) 40 
() 47 (}) 40 
() 48 {) 40 
() 49 () 40 
4 4A gd 4A 
3 4B ; 4B 
( 4C { 4C 
{ 4D { 4D 
+ 4E + 4E 
| 4F 4F 
& 50 & 50 
{) 51 {) 40 
{) 52 {) 40 
() 53 {) 40 
{}) 54 () 40 
{) 55 () 40 
() 56 () 40 
() 57 () 40 
() 58 () 40 
() 59 {) 40 
I 5A ! 5A 
$ 5B $ 5B 
* 5C v 5C 
) 5D ) 5D 
; 5E ; 5E 
4 5F - 5F 
_ 60 — 60 
] 61 / 61 
() 62 () 40 
{) 63 {) 40 
() 64 { }) 40 
{) 65 {}) 40 
(}) 66 () 40 
{) 67 {) 40 
() 68 (}) 40 
{}) 69 { ) 40 
i 6A () 40 
i 6B . 6B 
% 6C % 6C 
- 6D =: 6D 
> 6E > 6E 
? 6F ? 6F 








Da A 
Carattere Codice Carattere Codice 
{) 70 () 40 
() 71 {}) 40 
() 72 {) 40 
{) 73 {}) 40 
() 74 { }) 40 
{}) 75 {) 40 
{) 76 () 40 
() 77 {}) 40 
() 78 () 40 

È 79 ì 79 
3 7A : 7A 
# 78 # 7B 
@ 7C @ 7C 
! 7D ' 7D 
= 7E = 7E 
di ZE di ZE 
{) 80 {) 40 
a 81 A C1 
b 82 B c2 
c 83 C C3 
d 84 D C4 
e 85 E C5 
f 86 F C6 
9g 87 G C7 
h 88 H c8 
i 89 I Cc9 
{) 8A () 40 
() 8B () 40 
{) 8C {) 40 
{}) 8D {}) 40 
{}) 8E () 40 
() 8F {}) 40 
{) 90 () 40 
j 91 J DI 
k 92 K D2 
i 93 L D3 
m 94 M D4 
n 95 N D5 
o 96 O D6 
p 97 p D7 
q 98 Q D8 
r 99 R D9 
{) 9A {{}) 40 
() 9B {) 40 
{} 9C {_) 40 
{) 9D { } 40 
{) 9E () 40 
({) 9F () 40 


Fan 


Tabella #96E64 (continuazione) 


Carattere Codice Carattere Codice 


SODI TITIIZTIONM0OODR| I ---N<x x s < Chau —— 


) 
) 


— —  — —T—— — — —  —_ _ _ d_ LL rr I. }— — — — — 


— — — — — — 


AO 
AI 
A2 
AZ 
A4 
A5 
A6 
A7 
A8 
A9 
AA 
AB 
AC 
AD 
AE 
AF 
BO 
B1 
B2 
B3 
B4 
BS 
B6 
B7 
B8 
89 
BA 
BB 
BC 
BD 
BE 
BF 
co 
Ci 
c2 
C3 
C4 
C5 
C6 
C7 
c8 
C9 
CA 
CB 
Cc 
CD 
CE 
CF 


—|l— — — — —r — ———r 1 _—yT —P —P — —‘— — — —|l— — — — — — 


— — — — — — 


Carattere 


— 


— — — — — — — — — — — — 


n — — — — 


DO 
DI 

D2 

D3 
D4 

DS 
D6 
D7 

D8 
D9 
DA 
DB 
DC 
DD 
DE 
DEF 
EO 

EI 

E2 

E3 
E4 

ES 

E6 
E? 

E8 
E9 
EA 
EB 
EC 
ED 
EE 
EF 
FO 
FI 

F2 

F3 
F4 
F5 
F6 
F7 

F8 
F9 
FA 
FB 
FC 
FD 
FE 


— — — — — 


Codice Carattere 


— 


Codice 


865 


866 


Tabella #188E48 


Se è installata la cinghia di stampa carattere BELT48, usare questa tabella per 
far sì che i caratteri minuscoli vengano stampati come maiuscoli invece di spazi 
in bianco. Inoltre, i caratteri internazionali sono stampati come caratteri alfabe- 


tici invece che come spazi in bianco. 








Da 
Carattere Codice Carattere Codice 
{_} 40 {) 40 
() 41 () 40 
à 42 A C1 
à 43 A C1 
à 44 A ci 
a 45 A C1 
à 46 A CI 
E: 47 A CI 
GC 48 Cc C3 
n 49 N DS 
[ 4A {) 40 
. 48 A 48 
( 4C () 40 
{ 4D L;3 40 
+ 4E + 4E 
! 4F () 40 
& 50 & 50 
é 51 E C5 
(21 52 E C5 
è 53 E C5 
è 54 E C5 
î 55 I c9 
î 56 ) c9 
ri 57 I Cc9 
ì 58 I c9 
B 59 S E2 
] 5A (1) 40 
$ 5B $ 58 
* 5C * 5C 
) 5D () 40 
; 5E {}) 40 
A 5F BL) 40 
Ri 60 s 60 
/ 61 / 61 
R 62 A C1 
A 63 A C1 
À 64 A C1 
À 65 A CI 
K 66 A C1 
À 67 A ci 
G 68 C c3 
I 69 N D5 
‘ 6A {) 40 
' 6B E 6B 
% 6C % .6C 
È 6D E, 40 
) 6E (1) 40 
? 6F () 40 








Da A 
Carattere Codice Carattere Codice 
,) 70 (0) D6 
È 71 E C5 
€ 72 E C5 
E 73 E C5 
È 74 E C5 
i 75 I c9 
Î 76 I C9 
î 77 I c9 
pi 78 I c9 
ì 79 () 40 
: 7A {) 40 
# 7B # 78 
@® 7C @ 7C 
: 7D È 7D 
= 7E () 40 
" 7F () 40 
Ti) 80 lo) DE 
a 81 A C1 
b 82 B c2 
c 83 Cc C3 
d 84 D C4 
e 85 E C5 
f 86 F C6 
g 87 G C7 
h 88 H c8 
i 89 I c9 
« 8A () 40 
» 88 (1) 40 
d 8C D C4 
< 8D {}) 40 
p 8E {) 40 
È 8F {_) 40 
o 90 () 40 
j 91 J DI 
k 92 K D2 
I 93 L D3 
m 94 M DA 
n 95 N DS 
o 96 O D6 
p 97 p D7 
q 98 (6) D8 
r 99 R D9 
a 9A A C1 
I°) 9B O D6 
Li 9C {) 40 
» 9D (5) 40 
Li 9E {) 40 

9F (0) 40 


Tabella #188E48 (continuazione) 








Da A Da A 
Carattere Codice Carattere Codice Carattere Codice Carattere Codice 
K AO () 40 } DO () 40 
da AI {} 40 J DI J DI 
s A2 S E2 K D2 K D2 
t A3 T E3 L D3 L D3 
u A4 U E4 M D4 M D4 
v AS v E5 N DS N DS 
w AG W E6 O DE lo) D6 
x A7 x E7 P D7 p D7 
y A8 Y E8 lo) D8 le] D8 
z A9 Z E9 R DI R D9 
i AA {) 40 > DA {) 40 
È AB () 40 ù DB U E4 
D AC D C4 ù DC U E4 
U AD () 40 ù DB U E4 
b AE () 40 ù DE U E4 
®© AF (_) 40 yi DF Y E8 
d BO () 40 \ EO (1) 40 
£ BI () 40 (}) E1 () 40 
Y B2 {}) 40 S E2 S E2 
Pts B3 () 40 T E3 T E3 
f B4 () 40 U E4 U E4 
$& BS {) 40 Vv E5 v E5 
LI B6 () 40 W E6 W E6 
% B7 () 40 x E7 x E7 
% B8 {) 40 Y E8 Y E8 
% B9 () 40 Z E9 Z E9 
a BA {) 40 2 EA () 40 
| BB. ( ) 40 S EB O D6 
+ BC () 40 (o) EC lo) D6 

BD {) 40 ò ED o) D6 
; BE {) 40 6 EE (o) D6 
3 BF {_) 40 (O) EF O D6 
{ co {) 40 0 FO 0 FO 
A C1 A C1 1 E1 1 F1 
B c2 B c2 2 F2 2 F2 
Cc C3 C c3 3 F3 3 F3 
D c4 D cA 4 F4 4 F4 
E C5 E C5 5 F5 5 F5 
F C6 F C6 6 F6 6 F6 
G C7 G C7 7 F7 7 F7 
H c8 H c8 8 F8 8 F8 
I c9 I C9 9 F9 9 F9 
= CA = CA > FA () 40 
©) CB (0) D6 9) FB U E4 
le) CC O DE Ù FC U E4 
ò CD O D6 ù FD U E4 
6 CE lo) D6 i) FE U E4 
Ò CF O D6 
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Tabella #188E64 


Se è installata la cinghia di stampa carattere BELT64B o BELT64C, usare questa 
tabella per far sì che i caratteri minuscoli vengano stampati come maiuscoli inve- 
ce di spazi in bianco. Inoltre, i caratteri internazionali sono stampati come carat- 
teri alfabetici invece che come spazi in bianco, 


Da A Da A 
Carattere Codice Carattere Codice Carattere Codice Carattere Codice 
{) 40 {) 40 C.) 70 lo) DE 
{) 41 () 40 È 71 E C5 
à 42 A ci È 72 E C5 
à 43 A Ci È 73 E C5 
à 44 A CI È 74 E C5 
E 45 A c1 i 75 I c9 
à 46 A C1 î 76 I co 
a 47 A C1 Î 77 I c9 
G 48 Cc c3 i 78 I c9 
n 49 N D5 3 79 s 79 
[ 4A () 40 : 7A : 7A 
. 4B . 4B # 7B # 78 
{ 4C ( 4C @ 7C @ 7C 
( 4D ( 4D î 7D È 70 
+ 4E + 4E = 7E = 7E 
! 4F È 4F " 7F ” 7E 
& 50 & 50 0 80 lo) D6 
e 51 E C5 a 81 A Ci 
è 52 E C5 b 82 B c2 
é 53 E C5 c 83 C C3 
è 54 E C5 d 84 D C4 
î 55 I c9 e 85 E C5 
T 56 I c9 f 86 F C6 
î 57 I c9 9 87 G C7 
î 58 I c9 h 88 H c8 
B 59 S E2 i 89 I c9 
] 5A () 40 « 8A () 40 
$ 5B $ 5B » 88 () 40 
È 5C * 5C d 8C D c4 
) 50 ) 5D < 8D {} 40 
; 6E i 5E p 8E {) 40 
A 5F (_) 40 + 8F ({) 40 
3 60 _ 50 o 90 {) 40 
/ 61 / 61 j 91 J DI 
À 62 A c1 k 92 K D2 
A 63 A c1 I 93 L D3 
À 64 A C1 m 94 M D4 
A 65 A C1 n 95 N DS 
A 66 A C1 o 96 lo) DE 
À 67 A Ci p 97 p D7 
C 68 Cc C3 q 98 (o) D8 
N 69 N DS r 99 R D9 
' 6A {) 40 a 9A A Ci 
; 6B 3 68 () 9B O DE 
% 6C % 6C ® 9C { ) 40 
- 6D - 6D » 9D (1) 40 
) 6E ) 6E K 9E () 40 
? 6F ? 6F n 9F {) 40 
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Tabella #188E64 (continuazione) 


Da 


Carattere 


x 


4 T7)]Jrxegero > PT AOTIPLONTN<x st 
n 


CIONMIODpE|IC 


o O or O: O) | 


Codice Carattere 


AO 
AI 
A2 
AZ 
A4 
AB 
A6 
AI? 
A8 
A9 
AA 
AB 
AC 
AD 
AE 
AF 
BO 
B1 
B2 
B3 
B4 
B5 
B6 
B7 
B8 
B9 
BA 
BB 
BC 
BD 
BE 
BF 
co 
C1 
C2 
C3 
C4 
C5 
C6 
C7 
c8 
C9 
CA 
CB 
CC 
CD 
CE 
CF 


— — 


n n n 


_ 


Codice 


40 
40 
E2 
E3 
E4 
E5 
E6 
E7 
E8 
E9 
40 
40 
c4 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 

40 
ci 

c2 
C3 
c4 
C5 
C6 
C7 
c8 
c9 
40 

DE 
DE 
D6 
DE 
DE 


Codice 








Da 

Carattere Codice Carattere 
} DO () 40 
J DI J DI 
K D2 K D2 
L D3 L D3 
M D4 M D4 
N D5 N DS 
(o) D6 (0) D6 
P D7 P D7 
[e] D8 lo) D8 
R D9 R DI 
> DA () 40 
ù DB U E4 
ù DC Ù E4 
ù DD U E4 
ù DE U E4 
y DF Y E8 
\ EO \ EO 
() E1 () EI 
S E2 S E2 
T E3 T E3 
U E4 U E4 
Vv E5 Vv E5 
W E6 W E6 
x E7 x E7 
Y E8 Y E8 
Z E9 Z E9 

ù EA {) 40 
6 EB (O) D6 
lo) EC (o) D6 
ò ED lo) D6 
6 EE lo) D6 
lo) EF (0) D6 
0 FO 0 FO 
1 F1 1 F1 
2 F2 2 F2 
3 F3 3 F3 
4 F4 4 F4 
5 F5 5 F5 
6 F6 6 F6 
7 F7 7 F7 
8 F8 8 F8 
9 F9 9 F9 

> FA {) 40 
o) FB U E4 
tO) FC U E4 
Ù FD U E4 
ly) FE U E4 
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Tabella #188E96 


Se è installata la cinghia di stampa carattere BELT96, usare questa tabella per 
avere i caratteri internazionali stampati come caratteri ‘alfabetici invece che come 
spazi in bianco. 











Da A Da A 
Carattere Codice Carattere Codice Carattere Codice Carattere Codice 
{) 40 () 40 l) 70 o 96 
{) 41 (0). 40 É 71 E C5 
E\ 42 a 81 E 72 E C5 
d 43 a 81 È 73 E C5 
à 44 a 81 È 74 E C5 
a 45 a 81 I 75 I C9 
à 46 a 81 î 76 I C9 
& 47 a 81 bi 77 I c9 
C 48 c 83 î 78 I C9 
n 49 n 95 ‘ 79 i 79 
[ 4A {*) 40 : 7A : 7A 
. 4B . 4B # 78 # 7B 
( 4C ( 4C @ 7C @ 7C 
{ 4D ( 4D : 70 : 7D 
+ 4E + 4E = 7E = 7E 
| 4F 1 4F di 7F " 76 
& 50 & 50 te) 80 0 D6 
e 51 e 85 a 81 a 81 
8 52 e 85 b 82 b 82 
é 53 e 85 c 83 c 83 
è 54 e 85 d 84 d 84 
i 55 i 89 e 85 e 85 
î 56 ì 89 f 86 f 86 
î 57 i 89 9 87 g 87 
Ì 58 i 89 h 88 h 88 
6 59 s A2 i 89 i 89 
] 5A {}) 40 « 8A () 40 
$ 5B $ 5B » 8B {) 40 
» 5C * 5C d 8C d 84 
) 5D ) 5D < 8D {) 40 
; 6E ; 5E p 8E () 40 
A 5F () 40 + 8F .() 40 
i 60 = 60 . 90 {) 40 
/ 61 / 61 j 91 j 91 
À 62 A Ci k 92 k 92 
A 63 A CI I 93 I 93 
À 64 A CI m 94 m 94 
A 65 A c1 n 95 n 95 
K 66 A c1 o 96 o 96 
À 87 A c1 p 97 p 97 
G 68 C C3 q 98 q 98 
R 69 N D5 r 99 r 99 
6A ; 6A a 9A a 81 
: 6B ; 6B (e) 9B o 96 
% 6C % 6C è 9C (1) 40 
_ 6D _ 6D » 9D {) 40 
) 6E ) 6E & 9E {) 40 
? 6F ? 6F n 9F {) 40 
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Tabella #188E96 (continuazione) 


Da 
Carattere 


LR 


b) 


x 20 I KO AO TO TN <x £ << cv 


CTIONMQOQRIEAT]I 


OOo; O: 0)! 


AQ 
AI 
A2 
A3 
A4 
A5 
A6 
AI 
A8 
A9 
AA 
AB 
AC 
AD 
AE 
AF 
BO 
B1 
B2 
B3 
B4 
B5 
B6 
B7 
B8 
B9 
BA 
BB 
BC 
BD 
BE 
BF 
co 
C1 
C2 
C3 
C4 
C5 
C6 
C7 
C8 
C9 


CA . 


CB 
CC 
CD 
CE 
CF 


? cen 


o00°000T7TITONMOO0| 22429 N << £< ct 


Codice Carattere 


| — — — — —-  P— — — — — — — — —l1P— 1— — 


Codice 


40 
AI 
A2 
A3 
A4 
A5 
A6 
AI 
A8 
A9 
40 
40 
C4 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
40 
co 
CI 
C2 
c3 
C4 
C5 


$KEE8ESGZRZILE 


Da 
Carattere 


piNKXXS<CCANT CA CC Vv VOZEZrKAacC 


0 0 NODOUA WVN è C |OLO\O0/0: 0) 


w 


Ci Cr Ci C) 


DO 
DI 
D2 
D3 
D4 
D5 
D6 
D7 
D8 
D9 
DA 
DB 
DC 
DD 
DE 
DF 
EO 
E1 
E2 
E3 
E4 
ES 
E6 
E7 
E8 
E9 
EA 
EB 
EC 
ED 
EE 
EF 
FO 
FI 
F2 
F3 
F4 
F5 
F6 
F7 
F8 
F9 
FA 
FB 
FC 
FD 
FE 


CCCCT QLLNDPUKNAWN- 00 00O0O0TN<XxXS<CHAHU- --<ceccec-n07vO0ZZ3rxkxRC 


— 


— 


Codice Carattere 


— 


Codice 


DO 
DI 
D2 
D3 
D4 
D5 
D6 
D7 
D8 
D9 
40 

AA 
A4 
AA 
A4 
AB 
EO 
EI 

E2 
E3 
E4 
E5 
E6 
E7 
E8 
E9 
40 

D6 
D6 
D6 
D6 
D6 
FO 
FI 

F2 
F3 
F4 
F5 
F6 
F7 
F8 
F9 
4U 

E4 
E4 
E4 
E4 
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Tabelle dei codici EBCDIC e ASCII 


Appendice F. 


Nelle tabelle che seguono sono indicate le serie di caratteri EBCDIC e ASCII. 


Usare la serie che è supportata dal sistema, 


EBCDIC 


Per esempio, esadecimale CI (binario 1100 0001) è la lettera A. 








Posizioni di bit della memoria centrale 0, 1, 2,3 


a 
E z 


JOE È > |> 























delia memoria 


Posizioni di bit — 
centrale 


























Assegnazione doppia 
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ASCII 


Per esempio, esadecimale 41 (binario 0100 0001) è la lettera A, 


m 
N 
e 
e 
2 
e 
=] 
5 
Lo) 
“- 
o 
E 
1] 
E 
Ss 
IC 
ue) 
KA 
L 
tc] 
E 
2 
N 
‘n 
° 
a 


Posizioni di bit 


della memoria 
centrale 


4,5,6,7 
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Appendice G. Uso della Procedura IDDUXLAT 


INTRODUZIONE 


La procedura IDDUXLAT converte membri di programma origine RPG o definizioni dati 
del Sistema Gestione Testi (TMS) in nuovi campi IDDU, formati e definizioni di file. Que- 
sta appendice contiene le seguenti informazioni riguardo l’uso di IDDUXLAT: 


Considerazioni per l'elaborazione di IDDUXLAT, e regole relative a come IDDUX- 
LAT interpreta e converte le specifiche origine. 


Un esempio dell'uso di IDDUXLAT. Questo esempio include una lista delle specifi- 
che origine fornite in immissione a IDDUXLAT, e una stampa ricevuta in emissione 


da IDDUXLAT. 


Per la sintassi e la descrizione dei parametri della procedura IDDUXLAT, vedere il Capito- 
lo 4 di questo manuale. Per ulteriori informazioni circa l’IDDU, leggere Introduzione 
all'IDDU, SC13-5121 o le informazioni in linea per l'IDDU (scegliere l'opzione 11 del menù 
esplicativo dell’IDDU). 


CONSIDERAZIONI E REGOLE 


Cosa si dovrebbe considerare prima di avviare IDDUXLAT 


Le seguenti considerazioni dovrebbero essere fatte prima di avviare la procedura IDDUX- 
LAT: 


Usare la procedura IDDUXLAT per convertire membri origine privi di errori e compi- 
labili. 


La procedura IDDUXLAT non modifica le specifiche origine in nessun caso. 


La procedura IDDUXLAT può creare definizioni solo per i file su disco di immissione 
o di aggiornamento (eccetto i file di indirizzi e i file tabelle); tutti gli altri tipi di file, 
compresi i file di comunicazione e di terminale, sono ignorati e non possono essere 
convertiti. 
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In alcune circostanze, un file può essere descritto da specifiche in diversi membri 
origine. Se le specifiche che descrivono il file differiscono, IDDUXLAT creerà defini- 
zioni nuove e separate per ogni variazione. Perciò, molte definizioni (ognuna con un 
nome diverso) potevano essere state create per un file quando una sola definizione 
era sufficiente. 


Si dovrebbe quindi, evitare la possibilità di creare diverse e duplicate definizioni dei 
file anche se chiamate con nomi diversi. Esaminare attentamente il contenuto delle 
specifiche origine, e convertire ogni variazione delle specifiche di definizione file, 
solo una volta. 


La procedura IDDUXLAT può creare un massimo di 373 definizioni per ogni mem- 
bro origine elaborato. Se un membro che si desidera convertire contiene più di 373 
file, tracciati record e descrizioni campi, si consideri l'eventualità di dividere le speci- 
fiche origine in diverse parti. 


Se un solo membro contiene tutte le specifiche F e | per un file o un gruppo di file, 
solo questo membro deve essere convertito. 


Il tempo totale richiesto per convertire le specifiche origine e creare le definizioni di- 
pende dal numero di descrizioni contenute nelle specifiche. Se c'è un numero eleva- 
to di descrizioni da convertire, la procedura IDDUXLAT potrebbe degradare le pre- 
stazioni del sistema quando l'elaborazione è lanciata in modo interattivo. Quindi se 
un membro arigine contiene più di 150 descrizioni, si dovrebbe provvedere a lancia- 
re la procedura IDDUXLAT dalla coda lavori in modo blocchi. 


I formati record non sono sempre nominati nelle specifiche origine. La procedura 
IDDUXLAT, quindi, genera i nomi delle definizioni dei formati usando il prefisso del 
nome della definizione specificata seguito da un numero di sequenza di 4 cifre. 


Quando si converte un membro RPG Auto Report, la funzione COPY è ignorata. 


IDDUXLAT richiede che le definizioni dati TMS siano contenute nella libreria #DA- 
TADEF., Se le definizioni dati TMS non sono in questa libreria, usare la procedura 
LIBRLIBR per copiarle nella suddetta libreria. 


Quando si converte una definizione dati TMS, la procedura IDDUXLAT usa il nome 
della definizione dati come nome della prima definizione di formato che crea; quindi 
tutti i nomi dei formati sono generati usando il prefisso specificato seguito da un nu- 
mero di sequenza di 4 cifre. IDDUXLAT usa i campi di descrizione nelle specifiche | 
come testo per commenti corti e come testo delle intestazioni di colonna per le cor- 
rispondenti definizioni di campo. 
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e Tutti i commenti lunghi per le definizioni create dalla procedura IDDUXLAT, con- 
tengono: 


— Una indicazione che la definizione è stata creata dalla procedura IDDUXLAT e 
un elenco dei parametri usati. 


— La datae l'ora di creazione della definizione. 


— Per definizioni di file e di campo, il nome originale del file o del campo come 
specificato nelle specifiche origine. 


— Ii nome della libreria che contiene il membro origine. 
— Il nome del membro origine contenente le specifiche. 
— L’ID del programma trovato nelle specifiche H (se disponibile). 


— nomi dialtre definizioni che usano la definizione stessa (per esempio, il nome 
del file e le definizioni dei formati che usano la definizione del campo). 


Qui di seguito si può vedere un esempio di un lungo commento contenuto in una defini- 
zione campo creata da IDDUXLAT: 


FIELD - CUSNRX 

Creata da IDDUXLAT DICTRPG ,ACTREC , ,RPGLIB ,RPG ,FI, PRINT 
Data - 100384 Ora - 1037 

Nome Originale - CUSNRX 

Libreria - RPGLIB Membro Origine - ACTREC 

ID Programma RPG - ACTREC 

In File - DMASTER 

In Formato - FI0004 


e Sela procedura IDDUXLAT trova un errore nelle specifiche origine, o non è capace 
di convertire le specifiche, sono stampati dei messaggi di avvertimento o di termina- 
zione. 


Un messaggio di avvertimento è stampato se la procedura IDDUXLAT può conti- 
nuare ad elaborare il membro. Se IDDUXLAT non può convertire il membro, non è 
effettuata nessuna modifica al dizionario dati in emissione, tutte le specifiche non 
elaborate sono ignorate, un messaggio di terminazione è stampato e il prossimo 
membro richiesto è elaborato. 
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REGOLE RELATIVE ALLE SPECIFICHE ORIGINE 


Qui di seguito è descritto come la procedura IDDUXLAT interpreta le specifiche origine. 


Regole per l’interpretazione delle specifiche H (Controllo) 


Tutte le specifiche H contenenti un * (asterisco) o una / (barra) in colonna 7 sono 
ignorate. Un messaggio di avvertimento è stampato se è incontrato un comando di 
Auto Report /COPY. 


Se una specifica H non contiene un * 0 una / in colonna 7, il nome del program- 
ma nelle colonne da 75 a 80 è salvato per essere usato nel commento lungo per 
tutte le definizioni create da IDDUXLAT. 


Se non è incontrata una specifica H, o se il nome del programma nella prima specifi- 
ca Hè in bianco o invalido, nessun nome di programma è salvato. Le definizioni 
create da IDDUXLAT non sono influenzate e la conversione continua. 


Regole per l’interpretazione delle specifiche F (File) 


Se si sta convertendo una definizione dati TMS, ‘‘* DEF - ‘’ nelle colonne da 7 a 
12 e ‘“- ‘in colonna 43 sono interpretate come un nome tracciato record, se le 
colonne da 44 a 51 uguagliano una specifica file seguente. 


Le colonne da 13 a 20 devono contenere un nome di definizione di dati, e le colonne 
da 44 a 51 devono contenere un nome di file. 


Le seguenti condizioni si devono verificare; 


La prima posizione del nome del file (colonne da 7 a 14) devono contenere un 
carattere alfabetico (da A a Z, £, $, o 8). 


Il tipo di file (colonna 15) deve essere | (immissione) o U (aggiornamento). 


La designazione file (colonna 16) rion deve essere R (file di indirizzi record)o T 
{file tabelie). 


| primi quattro caratteri (colonne da 40 a 43) del tipo unità, deve essere DISK. 


Qualsiasi specifica F che non ha i suddetti requisiti, è ignorata, e un messaggio di avverti- 
mento è stampato. 


I comandi/COPY relativi all'’RPG Auto Report, sono ignorati. 


Le seguenti entrate sono controllate per verificarne la corretta sintassi: 


Il nome file specificato nelle colonne da 7 a 14. Se il nome è stato usato in spe- 
cifiche F precedenti, la specifica che si sta elaborando è ignorata. 


La lunghezza record deve essere tra 1 e 4096. 
Se si sta convertendo una definizione dati TMS, la breve descrizione del file 


{colonne da 75 a 98} è salvata e usata nel commento corto per la definizione file 
corrispondente. 
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Regole per l'interpretazione delle specifiche | (Immissione) 
Le specifiche | sono divise nella seguente maniera: 
e Commentie specifiche Auto Report (un * o una / in colonna 7) 


e Specifiche identificazioni file e tipo record. Questa categoria delle specifiche l inclu- 
de: 


— Specifiche | nome file 
— Specifiche | sequenza 
— Specifiche riga AND (estensione codice identificazione record) 
— Specifiche riga OR (estensione codice identificazione record) 
— Specifiche riga OR (descrizione formato di unione) 

e Specifiche I descrizione campo 

e Specifiche struttura dati 


® Specifiche Il descrizione campi struttura dati. 


Le seguenti regole si applicano per le specifiche I: 


e Tuttiicommentie specifiche | di auto report sono ignorate. Un messaggio di avver- 
timento è stampato se è incontrato un comando/COPY di Auto Report. È anche in- 
viato un messaggio che fornisce l’opzione per continuare l'elaborazione o cancellare 
la procedura IDDUXLAT. 


e Le convenzioni per le specifiche | di tipo record e file, sono: 


—  Unaspecifica | nome file è interpretata come l’inizio di una nuova sequenza di 
specifiche associate con il nome di file specificato. Se quel nome di file non era 
stato specificato in una specifica F precedente, tutte le specifiche | associate a 
quel nome di file sono ignorate. 


— Ogni specifica | di sequenza che segue, indica la fine di un tracciato record e 
l'inizio di una nuova descrizione di tracciato record per lo stesso file. Una sepa- 
rata definizione di formato è creata per ogni descrizione di tracciato record. 


— Le specifiche che seguono quelle relative alla sequenza o al nome del file, pos- 
sono essere una riga AND o OR o una specifica | di descrizione file. Un massi- 
mo di 20 righe OR possono seguire una specifica | di sequenza o nome file. 
Gli indicatori di identificazione record (colonne da 21 a 27, da 28 a 34 e da 35 a 
41) sono usate per identificare le descrizioni di tracciato record in un file a più 
tracciati. Un massimo di 70 codici di identificazione record possono essere 
associati con ogni specifica di sequenza o nome file, 


— Gli indicatori di relazione di record/campo (colonne 63 e 64) sono usati per as- 
sociare le specifiche | di descrizione campo con un particolare tracciato record. 
Queste variazioni nei tracciati record sono chiamate descrizioni tracciati aggan- 
ciati. IDDUXLAT crea una definizione formato separata per ognuno di queste 
descrizioni di tracciato. 
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Le convenzioni per le specifiche | di descrizione campo sono: 


Il tipo di dati è specificato in colonna 43. 


Le posizioni del campo FROM {colonne da 44 a 47) e TO (colonne da 48 a 51) 
indicano la posizione del campo entro il tracciato record. Le posizioni FROM e 
TO devono essere uguali o minori della lunghezza record del file. La posizione 
FROM deve essere minore o uguale alla posizione TO. 


La lunghezza campo deve essere compresa tra 1 e 4096 per dati in formato ca- 
rattere, tra 1 e 15 per dati in formato decimale, tra 1 e 8 per dati in formato de- 
cimale compatto e deve essere 2 o 4 per dati in formato binario. 

Per tipi di dati numerici, il numero di posizioni decimali (colonna 62) deve esse- 
re minore o uguale alla lunghezza del campo. Per dati in formato carattere il ti- 


po di dati (colonna 43) deve essere in bianco così come il numero di posizioni 
decimali. 


Il nome del campo è nelle colonne 53 - 58, In queste colonne si può anche met- 
tere una specifica di struttura dati o un nome di campo di struttura dati. 


Quando una relazione OR è usata tra nomi di campi, la relazione tra i campi nel- 
le colonne da 63 a 64 è usata per associare una descrizione di campo particola- 
re con una descrizione di tracciato record particolare. 

Se si sta convertendo una definizione dati TMS, la descrizione del campo può 
apparire nelle colonne da 75 a 90; la descrizione del campo diventa la intesta- 
zione del campo per la definizione del campo corrispondente. 


Se una H è presente in colonna 93, il campo contiene dati esadecimali. 


Un codice di edizione può apparire in colonna 94. Solo i seguenti codici di edi- 
zione sono ammessi. 


C Il punto decimale sarà una virgola 
D Il punto decimale sarà un punto 
Y Campo data 


Z Gli zeri a sinistra non sono mostrati. 


RT: 


e Leconvenzioniassociate conle specifiche | di struttura di dati e di campo di struttu- 
ra di dati sono: 


Una descrizione di struttura di dati è costituita da una specifica | relativa alla 
struttura dati possibilmente seguita da una o più specifiche | di descrizione di 
campo di struttura dati. La procedura IDDUXLAT riconosce una struttura di 
dati solo se è presente un nome di struttura. 


Le strutture di dati possono essere usate per ridefinire campi descritti da speci- 
fiche | di descrizione campo. Un campo è ridefinito in questa maniera usando il 
nome della struttura dati come nome del campo. 


Se una struttura dati ridefinisce una campo decimale numerico o carattere, le 
descrizioni dei campi nella struttura dati sono usate come descrizioni di campi 
normali. 
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Regole generali per l'interpretazione delle specifiche origine 


Tutte le righe di messaggi diagnostici (?? nelle colonne 12 e 13} sono ignorate dalla 
procedura IDDUXLAT. 


Si considera la fine dell'origine quando l’ultima specifica è convertita, o quando si 
incontra un ** 0/* nelle colonne da 1 a 3. 


Le specifiche F senza le corrispondenti specifiche | sono ignorate. Le specifiche | 
devono seguire la loro corrispondente specifica F. 


| nomi dei file non devono essere duplicati nelle specifiche F; comunque un nome di 
file può anche essere uguale a un nome di campo o a un nome di struttura dati. Una 
specifica F con un nome di file duplicato è ignorata. 


Un nome di campo può essere uguale al nome di una struttura dati se 1) il campo 
non appare nella struttura dati e 2) la lunghezza del campo è più grande o uguale 
della lunghezza totale di tutti i campi nella struttura dati. 


I nomi dei campi possono essere duplicati se la loro lunghezza, tipo di dati e posizio- 
ni decimali sono le stesse. Se questi attributi dei campi non sono uguali, viene stam- 
pato un messaggio di avvertimento. Se nomi di campi duplicati vengono incontrati 
entro lo stesso tracciato, un nuovo nome di definizione di campo viene generato per 
tutti eccetto itprimo campo. | nuovi nomi dei campi sono generati usando il prefisso 
del nome della definizione specificata nella procedura IDDUXLAT seguito da un nu- 
mero di sequenza di 4 cifre. 


| nomi delle strutture di dati non possono essere duplicati, e non devono essere 
uguali ad un nome di un campo della struttura dati. 


Campi strutturati e sovrapposti non sono previsti dalla procedura IDDUXLAT. Se 
sono incontrati, accade quanto segue: 


— Campi non sovrapposti che occupano le posizioni di tracciato record più basse 
{valori di posizione FROM più bassi) sono usati prima di campi che occupano 
posizioni di tracciato record più alte (valori di posizione FROM più grandi). 


— Sedueo più campi hanno la stessa posizione FROM, è usato il primo campo 
con la lunghezza più corta. 


— Campi di riempimento sono usati per definire aree di un tracciato record che 
non sono descritte con le specifiche | di descrizione campi. 


Se un codice di identificazione record è definito per una posizione del record che 
non è entro un campo definito da una specifica |, il codice stesso non è convertito e 
non è posto nella definizione del formato corrispondente. 


Esempio 


Nell'esempio seguente, le specifiche in un membro RPG origine chiamato ACTREC, con- 
tenuto in una libreria chiamata RPGLIB, sono convertite in definizioni IDDU. Le defini- 
Ni zioni IDDU sono memorizzate in un dizionario di dati IDDU chiamato DICTRPG. 


ACTREC contiene le specifiche di descrizione di file per diversi file su disco e di termina- 
le. Per lo scopo di questo esempio, si vedranno solo le informazioni al file su disco chia- 
mato DMASTER. Verranno mostrate le specifiche per DMASTER, i parametri usati nella 
procedura IDDUXLAT, e parti della stampa fornita dalla procedura stessa. 


Dati in immissione a IDDUXLAT: Specifiche RPG origine 


Qui di seguito si ha la descrizione delle specifiche origine RPG relative al file su disco 
DMASTER e alle definizioni da creare da quelle specifiche. 


Specifiche H 


Specifiche H (di controllo) contenute nel membro ACTREC: 


0001 Hx Wholesale Paper ficcounts Receivable Entry 
0002 H 016 AETREC 


La prima specifica H è ignorata perché con ‘e un asterisco (specifica commento) in co- 
lonna 7. 

La seconda specifica H indica al la totalità i memoria disponibile al programma per l’ela- 
borazione, e 6 il nome assegnato al programma. Il nome del programma è usato nei 
commenti lunghi per tutte le definizioni create da IDDUXLAT. 
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Specifiche F 


Qui di seguito sono riportate diverse specifiche F contenute nel programma ACTREC: 


0009 FSCREEN CP_F 180 WORKSTN ACTREC 
0010 F KNUM 4 ACTREC 
0011 F KSAVDS SCRIG ACTREC 
0012 F KID xD ACTREC 
0013 F KIND __ 10 ACTREC 
0055 FDFILEOI IC F 222 222R 4AI 4 DISK 150 ACTREC 
0056 FDFILEO2 IC F 64 648 2AI 4 DISK ACTREC 
0057 FDFILEO3 UC OF 64 64R6AI 3 DISK ACTREC 
0058 FIMASTER UC Fo S53 S3R DISK ACTREC 


d d é 


Le specifiche F nelle righe di programma da 0009 a 0013 descrivono un file su video; que- 
ste specifiche saranno ignorate dalla procedura IDDUXLAT. 


La specifica F nella riga di programma 0058 descrive un file chiamato DMASTER. Le en- 


trate in questa specifica F indicano che BI] DMASTER è [fun file su disco concatenato 
di aggiornamento ff. 
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Specifiche | 


Qui di seguito sono riportate le specifiche | contenute nel membro ACTR EC relative al file 
chiamato DMASTER: 


0069 IDMASTER NS 13 
0 OR 14 


so 
(e) 
ded ded ped DEA A pd ded fed pn ped pod bond Ped de ed dd Pond pnl den pon pon Pg ped bed hg pd bed pad pd end pdf ped bg ped ded ed ped i 


2 
$$ 


n 


Fal 


H 
2 CH 


L) 


NN 
88 


3 Co 
3 CR 


30 
3 CR 


WII 
38 


momo 


uovo nov 


mu 


3 CODEX 

POCUSNEX 
150 INUNRX 
2000ATEX 
1300ATEX 
200INUNRX 
21 SALCIX 
252INVAMK 
292C1SALX 
II2CNSAMX 
372INCSTX 
390SLENRKX 
AZOPRECNX 
AGONXRCNX 


3 CODEX 

9OCUSNAX 
150INUNRX 
200DATEX 

130DATEX 

200INUNRX 
242AMTRCX 
282C1SAMX 
322TTLCRX 
AZOPRECNX 
AG&ONXRCNX 


242TICRAX 
30 ADUNRX 
AZOPRECNX 
AGONXRCNX 


Le specifiche 1 per DMASTER usano una combinazione di BY indicatori identificazione 
record e [H indicatori di relazione campi per identificare un totale di 6 descrizioni di trac- 
ciato record. Conseguentemente, sei definizioni di formato saranno create per DMA- 


STER. 
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I parametri IDDUXLAT usati in questo esempio 


Il comando di procedura IDDUXLAT immesso è il seguente. 


IDDUXLAT DICTRPG,ACTREC,,RPGLIB, RPG,FI, PRINT 


OAaG da 


ds ddd 


specifica che le definizioni create da IDDUXLAT sono memorizzate nel dizionario 
dati chiamato DICTRPG. 


specifica che le specifiche convertite sono contenute nel mèmbro origine chiamato 
ACTREC. 


specifica che ACTREC è contenuto nella libreria RPGLIB 

specifica che ACTREC contiene specifiche origine RPG. 

specifica che se un nome campo è uguale al nome di una definizione esistente, ID- 
DUXLAT genera un nome di definizione campo nella forma Finnnn, dove nnnn è un 
numero di sequenza di 4 cifre. | nomi di definizione formati generati sono anche nel- 
la forma Finnnn. Se un nome di file è uguale al nome di una definizione file esisten- 


te, il nome della definizione file generata è nella forma Flnnnnnn. 


specifica che sono richieste tutte le stampe possibili. 


ami 


Stampa fornita da IDDUXLAT: Opzione PRINT 
Qui di seguito si descrive la stampa ricevuta dalla procedura IDDUXLAT. 
Sezione 1: Parametri IDDUXLAT specificati 


La procedura 1 della stampa elenca i parametri usati nella procedura IDDUXLAT: 


IHEHBHRBNAHOIA AA rana 5/36 TEDUXLAT SECTION 1 3909009000904 AO E 


ACTREC -RFGLIB 10/02/84 15124 Page- 1 


RPG II FRI Specification Translation Aid 


Data Dictionary Name DICTRPG 
Source Library Name --—-- RFGLIB 
Source Member Name -—--——- ACTREC 








TEXT/Subtype Entry RFG 
Field Name Prefix -—————- FI 
Print Option ---—--—-——- PRINT 
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Sezione 2: Lista del membro origine RPG e messaggi 


La sezione 2 della stampa elenca le specifiche origine convertite dalla IDDUXLAT. Qui di 
seguito è riportata una parte della Sezione 2 come è stampato per questo esempio: 


inn 
HBRGBRHIFAHRAFGA HABA: 9/35 TIDUXLAT SECTION 2 IH9BHHBAHIIA HA EE 
ACTREC -—RPGLIB 10/02/84 15124 Fage- 2 
RPG II Source Translated! 
000001 0001 Hx Wholesale Paper Accounts Receivable Entry 
000002 0002 H 016 ACTREC 
000003 0003. FIHBHBHHEAnHor Ion ord 09 HAR :00d00GNIA RIC TREC 
000004 0004 FX THIS VERSION OF SEE GIRO THE F o STATEMENTS 
000005 0005 Fx FOR ALL DATA BASES USED IN WHOLESALE ‘ 
000008 0008 Fx 4 TERMINALG SUPPORTED), BAXIMAI ACTREC 
* 08/06/84 DA fAST CHANGE L 
Penna DOO, Pei e eli lilunà 
000009 0009 FSCREEN CPF 180 WORKSTN ACTREC 
##xx%%* = F-Spec is not relevant to this translation - Ignored 
000010 SE, SA e ; i 4 ACTREC 
Hi Tmy i e on F-Spec - Ignore 
000011 Q0ii F Sar KSAYDS SCRIS ACTREC 
#XxX** Invalid File name on F-Spec - Ignored 
000012 0012 F KI xD ACTREC 
##%%%* Invalid File name on F-Spec - Ignored 
000013 0013 F KIND 10 ACTREC 
#%#%%* Invalid File name on F-Spec - Ignored 
La procedura IDDUXLAT riconosce che le specifiche F dalla riga 0009 alla riga 0013 de- 
scrivono un file su video. Siccome la procedura IDDUXLAT converte solo le specifiche F 
relative ai file su disco, alcuni messaggi stampati indicano che queste specifiche sono 
state ignorate. 
Le specifiche F e | per il file DMASTER sono state convertite senza errori. O 
= 


Sezione 3: Le definizioni IDDU create da IDDUXLAT 


La sezione 3 della stampa descrive brevemente ogni definizione di formato creata dalla 
procedura IDDUXLAT. Qui di seguito si ha la descrizione di una delle sei definizioni di 
formato create per DMASTER. 


BHUOBUGGRRUIHBRABAR HAV] 5/36 TIDUXLAT SECTION 3 MHBBHHUGUO OOO, 
ACTREC -RPGLIB 10/02/84 15124 Page- 10 
Data Dictionary Definitions Generated Contt 


@rite - DMASTER 
Grornat - FI0004 


Fields Start Length Nec Type Description 


cox O, 0 GO, 
CUSNEX 4 do 
INUNRX 10 6 0° 7 
* 16 i Cc Filler Field 
DATEX 17 4 0° P 
SALCOXM 21 1 C 
INVAM 22 4 2 P 
Gi cosax 26 42 P 
CNSAMX 30 4 2 
INCSTX = 34 420 
SLSNRX 38 207 
* 40 1 Cc Filler Field 
PRECNX Ai 30 2 
NXRCNX 44 3 0° 7 
* 47 7 C Filler Field 


Format - FI0004 placed in dictionary 


Ogni descrizione identifica: 


Il nome della definizione file che usa la definizione del formato. In questo esempio, il 
nome della definizione file (DMASTER) è uguale al nome usato nelle specifiche F. 


{Il nome della definizione di formato creato da IDDUXLAT. In questo esempio, ID- 
DUXLAT ha usato il prefisso della definizione specificato (FI) e ha aggiunto un nu- 
mero di sequenza di 4 cifre. FI0004 è stata la quarta definizione di formato creata. 
{Sebbene non mostrato in questo esempio, IDDUXLAT ha creato precedentemente 
tre definizioni di formato per altri file su disco usati da ACTREC). 


Una lista delle definizioni campi create da IDDUXLAT che sono usati dalla definizio- 
ne di formato. In questo esempio, IDDUXLAT ha usato i nomi dei campi specificati 
nelle specifiche 1 come nomi delle definizioni di campo. 


Un * (asterisco) nella colonna Campi indica che un campo di riempimento è stato 
creato per un’ area nel tracciato record che non è stato descritta da una specifica |. 
Le definizioni di campo non sono create per i campi di riempimento. 


La posizione di partenza di ogni definizione di campo usata dalla definizione di for- 
mato. 
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La lunghezza di ogni campo descritto da una definizione di campo. 
Il numero di posizione decimali in ogni campo numerico. 
Il tipo di dati di ogni campo. Sono usate le seguenti abbreviazioni: 


C Dati formato carattere 

B Dati numerici binari 

H Dati esadecimali 

P Dati numerici decimali compatti 
Z Dati numerici decimali Zonati 


Sezione 4: Messaggi e statistiche 


Qui di seguito è mostrata la sezione 4 della stampa: 


IE RITIRARE 5/35 TDDUXLAT SECTION 499090 


ACTREC -RPGLIB 10/02/84 15124 Page- 17 


SR 


© translation Was Successful 


Seurce Member errorsi 


G Nunber of Warnings ———— 7 


Definitions Created File Format Field 
Added to Dictionary ——--- 4 10 23 
Existing Iefinitions Used - 0 (o) 2-9 


*K**X*XXEND OF TRANSLATIONx®%k%x x 


IDDUXLAT ha creato con successo tutte le definizioni possibili 


È stato trovato e stampato un totale di sette errori di avvertimento. Oltre ai cinque 
errori mostrati precedentemente, ne sono stati trovati altri due non mostrati in que- 
sto esempio. 


Sono stati creati un totale di 4 nuove definizioni file, 10 nuove definizioni di forma- 
to, e 23 nuove definizioni di campo. 


Alcuni campi apparivano diverse volte nelle specifiche origine. In alcuni casi, un 
campo aveva esattamente le stesse caratteristiche (stesso tipo di dati, lunghezza 
campo, e numero di posizioni decimali) ogni volta che è stato incontrato. Se ID- 
DUXLAT aveva già creato una definizione per quel campo, verrà usata la stessa de- 
finizione. 

In questo esempio, le definizioni dei campi sono state usate per un totale di 42 volte. 
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